2007-10-12 17:32:20 +00:00
|
|
|
Welcome to tmux!
|
|
|
|
|
|
2018-05-22 07:02:06 +00:00
|
|
|
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.
|
2007-10-12 17:32:20 +00:00
|
|
|
|
2021-11-11 09:18:04 +00:00
|
|
|
This release runs on OpenBSD, FreeBSD, NetBSD, Linux, macOS and Solaris.
|
2008-11-17 18:35:27 +00:00
|
|
|
|
2019-05-11 06:55:28 +00:00
|
|
|
* Dependencies
|
2009-11-08 22:51:34 +00:00
|
|
|
|
2019-05-11 06:55:28 +00:00
|
|
|
tmux depends on libevent 2.x, available from:
|
|
|
|
|
|
|
|
|
|
https://github.com/libevent/libevent/releases/latest
|
2009-11-08 22:51:34 +00:00
|
|
|
|
2016-12-20 16:28:11 +00:00
|
|
|
It also depends on ncurses, available from:
|
|
|
|
|
|
2019-05-11 06:55:28 +00:00
|
|
|
https://invisible-mirror.net/archives/ncurses/
|
|
|
|
|
|
2020-09-25 08:43:35 +00:00
|
|
|
To build tmux, a C compiler (for example gcc or clang), make, pkg-config and a
|
|
|
|
|
suitable yacc (yacc or bison) are needed.
|
2020-09-25 08:41:41 +00:00
|
|
|
|
2019-05-11 06:55:28 +00:00
|
|
|
* Installation
|
2016-12-20 16:28:11 +00:00
|
|
|
|
2017-03-18 08:33:15 +00:00
|
|
|
To build and install tmux from a release tarball, use:
|
2011-09-15 12:58:39 +00:00
|
|
|
|
|
|
|
|
$ ./configure && make
|
|
|
|
|
$ sudo make install
|
|
|
|
|
|
2016-12-20 16:28:11 +00:00
|
|
|
tmux can use the utempter library to update utmp(5), if it is installed - run
|
|
|
|
|
configure with --enable-utempter to enable this.
|
2016-04-03 22:55:38 +00:00
|
|
|
|
2019-07-17 07:57:22 +00:00
|
|
|
To get and build the latest from version control - note that this requires
|
|
|
|
|
autoconf, automake and pkg-config:
|
2011-09-15 12:58:39 +00:00
|
|
|
|
2015-06-04 00:27:47 +00:00
|
|
|
$ git clone https://github.com/tmux/tmux.git
|
2012-10-05 08:05:44 +00:00
|
|
|
$ cd tmux
|
2011-09-15 12:58:39 +00:00
|
|
|
$ sh autogen.sh
|
2012-10-05 08:05:44 +00:00
|
|
|
$ ./configure && make
|
2024-10-04 22:26:18 +00:00
|
|
|
$ sudo make install
|
2012-10-05 08:05:44 +00:00
|
|
|
|
2019-05-11 06:55:28 +00:00
|
|
|
* Contributing
|
|
|
|
|
|
|
|
|
|
Bug reports, feature suggestions and especially code contributions are most
|
|
|
|
|
welcome. Please send by email to:
|
|
|
|
|
|
|
|
|
|
tmux-users@googlegroups.com
|
|
|
|
|
|
|
|
|
|
Or open a GitHub issue or pull request.
|
2011-09-15 12:58:39 +00:00
|
|
|
|
2019-05-11 06:55:28 +00:00
|
|
|
* Documentation
|
|
|
|
|
|
|
|
|
|
For documentation on using tmux, see the tmux.1 manpage. View it from the
|
|
|
|
|
source tree with:
|
2007-10-12 17:32:20 +00:00
|
|
|
|
2012-10-05 08:05:44 +00:00
|
|
|
$ nroff -mdoc tmux.1|less
|
2007-10-12 17:32:20 +00:00
|
|
|
|
2019-05-11 06:55:28 +00:00
|
|
|
A small example configuration is in example_tmux.conf.
|
2015-12-24 16:59:12 +00:00
|
|
|
|
2021-09-13 06:57:15 +00:00
|
|
|
Other documentation is available in the wiki:
|
|
|
|
|
|
|
|
|
|
https://github.com/tmux/tmux/wiki
|
|
|
|
|
|
|
|
|
|
Also see the tmux FAQ at:
|
|
|
|
|
|
|
|
|
|
https://github.com/tmux/tmux/wiki/FAQ
|
|
|
|
|
|
2019-05-11 06:55:28 +00:00
|
|
|
A bash(1) completion file is at:
|
2016-01-29 14:40:30 +00:00
|
|
|
|
2016-05-31 23:06:02 +00:00
|
|
|
https://github.com/imomaliev/tmux-bash-completion
|
2016-01-29 14:40:30 +00:00
|
|
|
|
2019-05-11 06:55:28 +00:00
|
|
|
For debugging, run tmux with -v and -vv to generate server and client log files
|
|
|
|
|
in the current directory.
|
2009-04-21 20:06:12 +00:00
|
|
|
|
2019-05-11 06:55:28 +00:00
|
|
|
* Support
|
2015-06-03 17:57:35 +00:00
|
|
|
|
2019-05-11 06:55:28 +00:00
|
|
|
The tmux mailing list for general discussion and bug reports is:
|
2015-06-03 17:57:35 +00:00
|
|
|
|
2019-05-11 06:55:28 +00:00
|
|
|
https://groups.google.com/forum/#!forum/tmux-users
|
2009-04-21 20:06:12 +00:00
|
|
|
|
2019-05-11 06:55:28 +00:00
|
|
|
Subscribe by sending an email to:
|
2016-06-06 08:30:39 +00:00
|
|
|
|
2019-05-11 06:55:28 +00:00
|
|
|
tmux-users+subscribe@googlegroups.com
|
2007-10-12 17:32:20 +00:00
|
|
|
|
2019-05-11 06:55:28 +00:00
|
|
|
* License
|
2007-10-12 17:32:20 +00:00
|
|
|
|
2019-05-18 13:44:31 +00:00
|
|
|
This file and the CHANGES files are licensed under the ISC license. All other
|
|
|
|
|
files have a license and copyright notice at their start.
|
