Overview
Each window displayed by tmux may be split into one or more panes. Each pane takes up a certain area of the display and is a separate terminal. Panes are numbered beginning from zero in the order they are created.split-window
Alias:splitw
Create the new pane to the left of or above the target pane.
Do not make the new pane the active pane.
Set an environment variable for the new pane in the form
VARIABLE=value. May be specified multiple times.Create a new pane spanning the full window height (with
-h) or width (with -v) instead of splitting the active pane.Split horizontally, creating a pane to the left or right.
Create an empty pane and forward any output from stdin to it.
Print information about the new pane after it has been created. Default format is
#{session_name}:#{window_index}.#{pane_index} but can be changed with -F.Split vertically, creating a pane above or below. This is the default.
Zoom the active pane if the window is not zoomed, or keep it zoomed if it was zoomed.
Specify the working directory for the new pane.
Format for output when
-P is used.Specify the size of the new pane in lines (for vertical split) or columns (for horizontal split). Can be specified as:
- A number of cells
- A percentage (e.g.,
50%)
The target pane to split.
Shell command to execute in the new pane.
kill-pane
Alias:killp
Kill all panes except the specified one.
The target pane to destroy.
select-pane
Alias:selectp
Select the pane below the active pane.
Disable input to the pane.
Enable input to the pane.
Select the pane to the left of the active pane.
Select the last (previously active) pane.
Clear the marked pane.
Mark the pane. The marked pane is the default target for
-s to join-pane, move-pane, swap-pane, and swap-window.Select the pane to the right of the active pane.
Select the pane above the active pane.
Keep the window zoomed if it was zoomed.
Set the pane title.
The target pane to select.
resize-pane
Alias:resizep
Resize downward by
adjustment (default 1).Resize to the left by
adjustment.Begin mouse resizing (only valid if bound to a mouse key binding).
Resize to the right by
adjustment.Trim all lines below the current cursor position and move lines out of the history.
Resize upward by
adjustment.Toggle the zoom state of the pane.
The target pane to resize.
Set absolute width. Can be a number or a percentage (e.g.,
50%).Set absolute height. Can be a number or a percentage.
The number of cells to resize by (default 1).
list-panes
Alias:lsp
List all panes across all sessions.
List all panes in the session.
Reverse the sort order.
Specify the format of each line.
Only show panes for which the filter is true.
Specify sort order:
index, left, top, right, bottom.List panes in the target window.
swap-pane
Alias:swapp
Do not change the active pane.
Swap with the pane below (or the bottom pane if the target is the bottom pane).
Swap with the pane above (or the top pane if the target is the top pane).
Keep the window zoomed if it was zoomed.
The source pane. If not specified, uses the marked pane.
The destination pane.
break-pane
Alias:breakp
Move the window to the next index after dst-window.
Move the window to the next index before dst-window.
Do not make the new window the current window.
Print information about the new window after it has been created.
Format for output when
-P is used.Name for the new window.
The source pane to break out.
The destination window position.
join-pane
Alias:joinp, movep
break-pane.
Join the pane to the left of or above the target pane.
Do not make the joined pane the active pane.
Create a pane spanning the full window height (with
-h) or width (with -v).Join horizontally (create a pane to the left or right).
Join vertically (create a pane above or below). This is the default.
Specify the size of the joined pane in lines (for vertical) or columns (for horizontal).
The source pane to join. If not specified, uses the marked pane.
The destination pane.
display-panes
Alias:displayp
Do not block other commands from running until the indicator is closed.
Ignore keys pressed.
Duration in milliseconds for which the indicator is shown. A duration of 0 means until a key is pressed.
The target client.
If a key is pressed, template is executed as a command with
%% replaced by the pane ID.respawn-pane
Alias:respawnp
Specify the working directory for the command.
Set an environment variable in the form
VARIABLE=value. May be specified multiple times.Kill the existing command if it is still running.
The target pane to respawn.
Shell command to execute. If not specified, the command used when the pane was created is reused.
pipe-pane
Alias:pipep
Pipe output from stdin to the pane.
Pipe output from the pane to shell-command.
Only open a new pipe if none is currently open.
The target pane.
Shell command to pipe output to or from. If not specified and a pipe is currently open, it is closed.
capture-pane
Alias:capturep
Use the alternate screen if present.
Escape non-printable characters as octal \ooo.
Include escape sequences for attributes.
Join wrapped lines and preserve trailing whitespace.
Preserve trailing spaces.
Print the captured text to stdout.
Only capture text that is the beginning of an as-yet incomplete line.
Do not output to stdout when
-p is used.Name for the paste buffer to store the captured text.
End line number. Negative numbers count from the bottom, 0 is the first line of visible pane content.
Start line number. Negative numbers count from the bottom, 0 is the first line of visible pane content.
The target pane.
select-layout
Alias:selectl
Spread the panes out evenly.
Select the next layout.
Undo the last layout change.
Select the previous layout.
The target pane (window will be selected).
Layout name:
even-horizontal, even-vertical, main-horizontal, main-vertical, tiled, or a custom layout string.