tmuxtmuxOptions, hooks and formats

Choose documentation 1

3.2a

tmux catalog version

Latest (3.7c) 3.7c 3.2a
English

tmux 3.2a options, hooks and formats

tmux 3.2a options

Settings for the server, sessions, windows and panes, with their types, defaults and allowed values. The list covers tmux 3.2a, 104 entries.

Session options47

activity-action
Set action on window activity when monitor-activity is on.
assume-paste-time
If keys are entered faster than one in milliseconds, they are assumed to have been pasted rather than typed and tmux key bindings are not processed.
base-index
Set the base index from which an unused index should be searched when a new window is created.
bell-action
Set action on a bell in a window when monitor-bell is on.
default-command
Set the command used for new windows (if not specified when the window is created) to shell-command, which may be any sh(1) command.
default-shell
Specify the default shell.
default-size
Set the default size of new windows when the window-size option is set to manual or when a session is created with new-session-d.
destroy-unattached
If enabled and the session is no longer attached to any clients, it is destroyed.
detach-on-destroy
If on (the default), the client is detached when the session it is attached to is destroyed.
display-panes-active-colour
Set the colour used by the display-panes command to show the indicator for the active pane.
display-panes-colour
Set the colour used by the display-panes command to show the indicators for inactive panes.
display-panes-time
Set the time in milliseconds for which the indicators shown by the display-panes command appear.
display-time
Set the amount of time for which status line messages and other on-screen indicators are displayed.
history-limit
Set the maximum number of lines held in window history.
key-table
Set the default key table to key-table instead of root.
lock-after-time
Lock the session (like the lock-session command) after number seconds of inactivity.
lock-command
Command to run when locking each client.
message-command-style
Set status line message command style.
message-style
Set status line message style.
mouse
If on, tmux captures the mouse and allows mouse events to be bound as key bindings.
prefix
Set the key accepted as a prefix key.
prefix2
Set a secondary key accepted as a prefix key.
renumber-windows
If on, when a window is closed in a session, automatically renumber the other windows in numerical order.
repeat-time
Allow multiple commands to be entered without pressing the prefix-key again in the specified time milliseconds (the default is 500).
set-titles
Attempt to set the client terminal title using the tsl and fslterminfo(5) entries if they exist.
set-titles-string
String used to set the client terminal title if set-titles is on.
silence-action
Set action on window silence when monitor-silence is on.
status
Show or hide the status line or specify its size.
status-bg
Background colour of the status line. This option is deprecated, use 'status-style' instead.
status-fg
Foreground colour of the status line. This option is deprecated, use 'status-style' instead.
status-format
Specify the format to be used for each line of the status line.
status-interval
Update the status line every interval seconds.
status-justify
Set the position of the window list in the status line: left, centre or right.
status-keys
Use vi or emacs-style key bindings in the status line, for example at the command prompt.
status-left
Display string (by default the session name) to the left of the status line.
status-left-length
Set the maximum length of the left component of the status line.
status-left-style
Set the style of the left part of the status line.
status-position
Set the position of the status line.
status-right
Display string to the right of the status line.
status-right-length
Set the maximum length of the right component of the status line.
status-right-style
Set the style of the right part of the status line.
status-style
Set status line style.
update-environment
Set list of environment variables to be copied into the session environment when a new session is created or an existing session is attached.
visual-activity
If on, display a message instead of sending a bell when activity occurs in a window for which the monitor-activity window option is enabled.
visual-bell
If on, a message is shown on a bell in a window for which the monitor-bell window option is enabled instead of it being passed through to the terminal (which normally makes a sound).
visual-silence
If monitor-silence is enabled, prints a message after the interval has expired on a given window instead of sending a bell.
word-separators
Sets the session's conception of what characters are considered word separators, for the purposes of the next and previous word commands in copy mode.

Window options34

aggressive-resize
Aggressively resize the chosen window.
automatic-rename
Control automatic window renaming.
automatic-rename-format
The format (see FORMATS) used when the automatic-rename option is enabled.
clock-mode-colour
Set clock colour.
clock-mode-style
Set clock hour format.
copy-mode-current-match-style
Set the style of the current search match in copy mode.
copy-mode-mark-style
Set the style of the line containing the mark in copy mode.
copy-mode-match-style
Set the style of search matches in copy mode.
main-pane-height
Set the width or height of the main (left or top) pane in the main-horizontal or main-vertical layouts.
main-pane-width
Set the width or height of the main (left or top) pane in the main-horizontal or main-vertical layouts.
mode-keys
Use vi or emacs-style key bindings in copy mode.
mode-style
Set window modes style.
monitor-activity
Monitor for activity in the window.
monitor-bell
Monitor for a bell in the window.
monitor-silence
Monitor for silence (no activity) in the window within interval seconds.
other-pane-height
Set the height of the other panes (not the main pane) in the main-horizontal layout.
other-pane-width
Like other-pane-height, but set the width of other panes in the main-vertical layout.
pane-active-border-style
Set the pane border style for the currently active pane.
pane-base-index
Like base-index, but set the starting index for pane numbers.
pane-border-format
Set the text shown in pane border status lines.
pane-border-lines
Set the type of characters used for drawing pane borders.
pane-border-status
Turn pane border status lines off or set their position.
pane-border-style
Set the pane border style for panes aside from the active pane.
window-size
Configure how tmux determines the window size.
window-status-activity-style
Set status line style for windows with an activity alert.
window-status-bell-style
Set status line style for windows with a bell alert.
window-status-current-format
Like window-status-format, but is the format used when the window is the current window.
window-status-current-style
Set status line style for the currently active window.
window-status-format
Set the format in which the window is displayed in the status line window list.
window-status-last-style
Set status line style for the last active window.
window-status-separator
Sets the separator drawn between windows in the status line.
window-status-style
Set status line style for a single window.
wrap-search
If this option is set, searches will wrap around the end of the pane contents.
xterm-keys
Whether xterm-style function key sequences should be sent. This option is no longer used.

Window and pane options6

allow-rename
Allow programs in the pane to change the window name using a terminal escape sequence (\ek...\e\\).
alternate-screen
This option configures whether programs running inside the pane may use the terminal alternate screen feature, which allows the smcup and rmcupterminfo(5) capabilities.
remain-on-exit
A pane with this flag set is not destroyed when the program running in it exits.
synchronize-panes
Duplicate input to all other panes in the same window where this option is also on (only for panes that are not in any mode).
window-active-style
Set the pane style when it is the active pane.
window-style
Set the pane style.

Server options17

backspace
Set the key sent by tmux for backspace.
buffer-limit
Set the number of buffers; as new buffers are added to the top of the stack, old ones are removed from the bottom if necessary to maintain this maximum length.
command-alias
This is an array of custom aliases for commands.
copy-command
Give the command to pipe to if the copy-pipe copy mode command is used without arguments.
default-terminal
Set the default terminal for new windows created in this session - the default value of the TERM environment variable.
editor
Set the command used when tmux runs an editor.
escape-time
Set the time in milliseconds for which tmux waits after an escape is input to determine if it is part of a function or meta key sequences.
exit-empty
If enabled (the default), the server will exit when there are no active sessions.
exit-unattached
If enabled, the server will exit when there are no attached clients.
extended-keys
When on or always, the escape sequence to enable extended keys is sent to the terminal, if tmux knows that it is supported.
focus-events
When enabled, focus events are requested from the terminal if supported and passed through to applications running in tmux.
history-file
If not empty, a file to which tmux will write command prompt history on exit and load it from on start.
message-limit
Set the number of error or information messages to save in the message log for each client.
set-clipboard
Attempt to set the terminal clipboard content using the xterm(1) escape sequence, if there is an Ms entry in the terminfo(5) description (see the TERMINFO EXTENSIONS section).
terminal-features
Set terminal features for terminal types read from terminfo(5).
terminal-overrides
Allow terminal descriptions read using terminfo(5) to be overridden.
user-keys
Set list of user-defined key escape sequences.
Esc

Type to search.

Reference preview Open reference