1TMUX(1)                   BSD General Commands Manual                  TMUX(1)
2

NAME

4     tmux — terminal multiplexer
5

SYNOPSIS

7     tmux [-2CluvV] [-c shell-command] [-f file] [-L socket-name]
8          [-S socket-path] [command [flags]]
9

DESCRIPTION

11     tmux is a terminal multiplexer: it enables a number of terminals to be
12     created, accessed, and controlled from a single screen.  tmux may be
13     detached from a screen and continue running in the background, then later
14     reattached.
15
16     When tmux is started it creates a new session with a single window and
17     displays it on screen.  A status line at the bottom of the screen shows
18     information on the current session and is used to enter interactive com‐
19     mands.
20
21     A session is a single collection of pseudo terminals under the management
22     of tmux.  Each session has one or more windows linked to it.  A window
23     occupies the entire screen and may be split into rectangular panes, each
24     of which is a separate pseudo terminal (the pty(4) manual page documents
25     the technical details of pseudo terminals).  Any number of tmux instances
26     may connect to the same session, and any number of windows may be present
27     in the same session.  Once all sessions are killed, tmux exits.
28
29     Each session is persistent and will survive accidental disconnection
30     (such as ssh(1) connection timeout) or intentional detaching (with the
31     ‘C-b d’ key strokes).  tmux may be reattached using:
32
33           $ tmux attach
34
35     In tmux, a session is displayed on screen by a client and all sessions
36     are managed by a single server.  The server and each client are separate
37     processes which communicate through a socket in /tmp.
38
39     The options are as follows:
40
41     -2            Force tmux to assume the terminal supports 256 colours.
42
43     -C            Start in control mode (see the CONTROL MODE section).
44                   Given twice (-CC) disables echo.
45
46     -c shell-command
47                   Execute shell-command using the default shell.  If neces‐
48                   sary, the tmux server will be started to retrieve the
49                   default-shell option.  This option is for compatibility
50                   with sh(1) when tmux is used as a login shell.
51
52     -f file       Specify an alternative configuration file.  By default,
53                   tmux loads the system configuration file from
54                   /etc/tmux.conf, if present, then looks for a user configu‐
55                   ration file at ~/.tmux.conf.
56
57                   The configuration file is a set of tmux commands which are
58                   executed in sequence when the server is first started.
59                   tmux loads configuration files once when the server process
60                   has started.  The source-file command may be used to load a
61                   file later.
62
6