Workspace ManagerconceptConfiguration

Choose documentation 3

latest

Current version

latest
English

Early release libtmux is released, and its APIs may still change between releases. This site's structure and URLs may change too.

Edit this page on GitHub

Window layouts

@libtmux/workspace 0.1.0-alpha.12 · Source

Choose a layout for each window. even-horizontal gives panes equal widths:

layouts.yaml
session_name: layouts-example
windows:
- window_name: work
layout: even-horizontal
panes: [null, null, null]

Other common tmux names include even-vertical, main-horizontal, main-vertical and tiled. Full names avoid version-dependent abbreviation ambiguity. Available names follow the selected tmux daemon.

Saved layouts and terminal size

A captured layout describes pane geometry. Loading validates its syntax and pane capacity, then tmux applies it to the actual window size. Resizing can change the final dimensions. Use a named layout when exact saved geometry is unnecessary.

Set window and pane focus explicitly when the active target matters. Layout arrangement and active-pane selection are different settings.

Capture can save a running layout; inspect it before reloading on a smaller terminal.

CLI source.

Esc

Type to search.

Reference previewOpen reference