NAME

tmux —

terminal multiplexer

SYNOPSIS

tmux [-vV] [-S socket-path] [-s session-name] command [arguments]

DESCRIPTION

tmux is a terminal multiplexer; it enables a number of terminals (or windows) to be accessed and controlled from a single terminal.

tmux runs as a server-client system. A server is created automatically when necessary and holds a number of sessions, each of which may have a number of windows connected to it. Any number of clients may connect to a session, or the server may be controlled by issuing commands with tmux. Communication takes place through a socket, by default placed in /tmp.

The options are as follows:

-S socket-path: This specifies an alternative path to the server socket. The default is /tmp/tmux-UID, where UID is the uid of the user who invoked tmux.
-s session-name: Apply command to the session named session-name. This option does not apply to all commands. If it is omitted and tmux is invoked from a running tmux client, the session the containing client is connected to will be used; otherwise, if only one session exists, it is chosen, or if multiple sessions exist, an error is generated.
-v: Request verbose logging. This option may be specified multiple times for increasing verbosity. Log messages will be saved into tmux-client-PID.log and tmux-server-PID.log files in the current directory, where PID is the pid of the server or client process.
command [arguments]: This specifies one of a set of commands used to control tmux, and described in the following sections.

KEY BINDINGS

tmux may be controlled from an attached client by using a key combination of a prefix, ‘^A’ (ctrl-A) by default, followed by a command key.

Some of the default key bindings include:

‘d’: Detach current client.
‘c’: Create new window.
‘n’: Change to next window in the current session.
‘p’: Change to previous window in the current session.
‘l’: Move to last (previously selected) window in the current session.
‘?’: List current key bindings.

A complete list may be obtained with the list-keys command (bound to ‘?’ by default). Key bindings may be changed with the bind-key and unbind-key commands.

COMMANDS

tmux supports the following commands:

attach-session [-d]: (alias: attach)
bind-key key command [arguments]: (alias: bind)
detach-session [-a]: (alias: detach)
has-session: (alias: has)
kill-session
kill-window [-i index]: (alias: killw)
last-window: (alias: last)
link-window [-i index] name index: (alias: linkw)
list-clients: (alias: lsc)
list-keys: (alias: lsk)
list-sessions: (alias: ls)
list-windows: (alias: lsw)
new-session [-d] [-s session-name] [-n window-name] [command]: (alias: new)
new-window [-d] [-i index] [-n name] [command]: (alias: neww)
next-window: (alias: next)
previous-window: (alias: prev)
refresh-session [-a]: (alias: refresh)
rename-session new-name: (alias: rename)
rename-window [-i index] new-name: (alias: renamew)
select-window index: (alias: selectw)
send-prefix
set-option) option value: (alias: set)
prefix,status,status-fg,status-bg,bell-action,default-command
swap-window [-i index] name index: (alias: swapw)
unbind-key key: (alias: unbind)
unlink-window [-i index]: (alias: unlinkw)

AUTHORS

Nicholas Marriott ⟨nicm@users.sourceforge.net⟩

November 9, 2007