Welcome to tmux!

tmux is a terminal multiplexer: it enables a number of terminals to be created, accessed, and controlled from a single screen. tmux may be detached from a screen and continue running in the background, then later reattached.

This release runs on OpenBSD, FreeBSD, NetBSD, Linux, macOS and Solaris.

  • Dependencies

tmux depends on libevent 2.x, available from:

It also depends on ncurses, available from:

To build tmux, a C compiler (for example gcc or clang), make, pkg-config and a suitable yacc (yacc or bison) are needed.

  • Installation

To build and install tmux from a release tarball, use:

$ ./configure && make
$ sudo make install

tmux can use the utempter library to update utmp(5), if it is installed - run configure with --enable-utempter to enable this.

To get and build the latest from version control - note that this requires autoconf, automake and pkg-config:

$ git clone
$ cd tmux
$ sh
$ ./configure && make
  • Contributing

Bug reports, feature suggestions and especially code contributions are most welcome. Please send by email to:

[email protected]

Or open a GitHub issue or pull request.

  • Documentation

For documentation on using tmux, see the tmux.1 manpage. View it from the source tree with:

$ nroff -mdoc tmux.1|less

A small example configuration is in example_tmux.conf.

Other documentation is available in the wiki:

Also see the tmux FAQ at:

A bash(1) completion file is at:

For debugging, run tmux with -v and -vv to generate server and client log files in the current directory.

  • Support

The tmux mailing list for general discussion and bug reports is:!forum/tmux-users

Subscribe by sending an email to:

[email protected]
  • License

This file and the CHANGES files are licensed under the ISC license. All other files have a license and copyright notice at their start.

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.