Workspace ManagerConfiguration

Choose documentation 3

latest

Current version

latest
English

Prerelease This site documents an alpha of libtmux. Its structure, URLs and APIs are subject to change.

Edit this page on GitHub

Window layouts

LibTmux.Workspace 0.0.0-alpha.20 · 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.