Skip to content

tmux/tmux

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Repository files navigation

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 onlibevent2.x, available fromthis page.

It also depends onncurses,available fromthis page.

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

Installation

Binary packages

Some platforms provide binary packages for tmux, although these are sometimes out of date. Examples are listed on this page.

From release tarball

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-utempterto enable this.

For more detailed instructions on building and installing tmux, see this page.

From version control

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

git clone https://github /tmux/tmux.git
cdtmux
sh autogen.sh
./configure&&make

Contributing

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

tmux-users@googlegroups

Or open a GitHub issue or pull request.Please readthis documentbefore opening an issue.

There isa list of suggestions for contributions. Please feel free to ask on the mailing list if you're thinking of working on something or need further information.

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 inexample_tmux.conf.

And a bash(1) completion file at:

https://github /imomaliev/tmux-bash-completion

For debugging, run tmux with-vor-vvto generate server and client log files in the current directory.

Support

The tmux mailing list for general discussion and bug reports is:

https://groups.google /forum/#!forum/tmux-users

Subscribe by sending an email to:

tmux-users+subscribe@googlegroups