Go to file
2021-03-02 12:01:25 +00:00
.github Show config.log on failure. 2021-01-17 18:47:14 +00:00
compat Add compat clock_gettime for older macOS. GitHub issue 2555. 2021-02-05 11:01:21 +00:00
fuzz Scaffold for oss-fuzz, from Sergey Nizovtsev. 2020-11-09 16:44:39 +00:00
logo Add tmux logo, createed by Jason Long. 2015-04-28 13:46:47 +01:00
presentations Add a couple of presentations I wrote a few years ago. One for the ill-fated 2015-06-04 08:23:40 +01:00
regress OSC 11 test. 2021-02-15 09:40:50 +00:00
tools No paths.h. 2020-05-16 20:27:00 +01:00
.gitignore Scaffold for oss-fuzz, from Sergey Nizovtsev. 2020-11-09 16:44:39 +00:00
.mailmap Add to .mailmap. 2016-07-19 10:42:44 +01:00
.travis.yml Add FreeBSD CI, from Jan Beich. 2020-05-19 12:34:34 +01:00
alerts.c Look for libevent2 differently from libevent for platforms with both. 2021-01-17 17:21:51 +00:00
arguments.c Merge branch 'obsd-master' 2020-06-12 10:01:19 +01:00
attributes.c Add an attribute for ACS. 2020-05-16 14:13:37 +00:00
autogen.sh Bump automake and autoconf versions. 2017-03-22 08:45:53 +00:00
cfg.c Merge branch 'obsd-master' into master 2021-02-22 10:01:22 +00:00
CHANGES Back to 3.3. 2020-11-03 08:41:24 +00:00
client.c Merge branch 'obsd-master' into master 2021-02-17 09:58:51 +00:00
cmd-attach-session.c Do not free old session working directory until after expanding the new 2020-09-03 12:47:33 +00:00
cmd-bind-key.c Allow -N without a command to change or add a note to an existing key. 2020-09-08 10:19:19 +00:00
cmd-break-pane.c Add -b flags to insert a window before (like the existing -a for after) 2020-06-13 09:05:53 +00:00
cmd-capture-pane.c Instead of sending all data to control mode clients as fast as possible, 2020-06-01 09:43:00 +00:00
cmd-choose-tree.c Add a customize mode where keys and options may be browsed and changed, 2020-05-16 16:02:24 +00:00
cmd-command-prompt.c Expand target from client and use it to expand the prompt. 2020-05-16 16:16:07 +00:00
cmd-confirm-before.c Expand target from client and use it to expand the prompt. 2020-05-16 16:16:07 +00:00
cmd-copy-mode.c Move cmdq_state into cmd-queue.c. 2020-04-13 14:46:04 +00:00
cmd-detach-client.c Make client -c and -t handling common in cmd-queue.c and try to be 2020-04-13 20:51:57 +00:00
cmd-display-menu.c Drop support for popups where the content is provided directly to tmux 2021-03-02 10:56:45 +00:00
cmd-display-message.c Add a -d option to display-message to set delay, from theonekeyg at 2020-07-27 08:03:10 +00:00
cmd-display-panes.c Add -N flag to display-panes to ignore keys, GitHub issue 2473. 2020-11-26 09:19:10 +00:00
cmd-find-window.c Add -i to find-window to ignore case. 2020-05-29 13:42:13 +00:00
cmd-find.c Add a client flag 'active-pane' which stores the active pane in the 2020-05-16 16:20:59 +00:00
cmd-if-shell.c Drop support for popups where the content is provided directly to tmux 2021-03-02 10:56:45 +00:00
cmd-join-pane.c Merge branch 'obsd-master' into master 2021-01-06 10:01:22 +00:00
cmd-kill-pane.c Add a client flag 'active-pane' which stores the active pane in the 2020-05-16 16:20:59 +00:00
cmd-kill-server.c Make struct cmd local to cmd.c and move it out of tmux.h. 2020-04-13 08:26:27 +00:00
cmd-kill-session.c Also move cmdq_item and cmdq_list into cmd-queue.c (this is to make its 2020-04-13 10:59:58 +00:00
cmd-kill-window.c kill-window -a cannot just walk the list of windows because if 2020-07-04 14:24:02 +00:00
cmd-list-buffers.c Also move cmdq_item and cmdq_list into cmd-queue.c (this is to make its 2020-04-13 10:59:58 +00:00
cmd-list-clients.c Change the existing client flags for control mode to apply for any 2020-05-16 15:45:29 +00:00
cmd-list-keys.c Add a -d option to display-message to set delay, from theonekeyg at 2020-07-27 08:03:10 +00:00
cmd-list-panes.c Also move cmdq_item and cmdq_list into cmd-queue.c (this is to make its 2020-04-13 10:59:58 +00:00
cmd-list-sessions.c Also move cmdq_item and cmdq_list into cmd-queue.c (this is to make its 2020-04-13 10:59:58 +00:00
cmd-list-windows.c Change so that window_flags escapes # automatically which means configs 2021-01-20 07:16:54 +00:00
cmd-load-buffer.c calloc cb data so the client is NULL. 2020-09-04 12:24:25 +00:00
cmd-lock-server.c Missed a few warnings in previous. 2020-04-13 20:54:15 +00:00
cmd-move-window.c Add -b flags to insert a window before (like the existing -a for after) 2020-06-13 09:05:53 +00:00
cmd-new-session.c Instead of sending all data to control mode clients as fast as possible, 2020-06-01 09:43:00 +00:00
cmd-new-window.c Add a -S flag to new-window to make it select the existing window if one 2021-02-05 12:23:49 +00:00
cmd-parse.y Leave newlines inside multiline quotes. 2020-12-01 10:48:03 +00:00
cmd-paste-buffer.c Merge branch 'obsd-master' 2020-04-13 14:01:45 +01:00
cmd-pipe-pane.c Merge branch 'obsd-master' 2020-05-21 08:55:31 +01:00
cmd-queue.c Ignore running command when checking for no-hooks flag if it is blocked. 2020-11-30 13:37:45 +00:00
cmd-refresh-client.c Add a way for control mode clients to subscribe to a format and be 2020-07-06 09:14:20 +00:00
cmd-rename-session.c Instead of forbidding invalid session names, sanitize them like window 2020-05-16 14:49:50 +00:00
cmd-rename-window.c Drop having a separate type for style options and make them all strings, 2020-05-16 15:01:30 +00:00
cmd-resize-pane.c Fix some error strings, from Kris Katterjohn. 2020-05-25 18:17:14 +00:00
cmd-resize-window.c Also move cmdq_item and cmdq_list into cmd-queue.c (this is to make its 2020-04-13 10:59:58 +00:00
cmd-respawn-pane.c Drop having a separate type for style options and make them all strings, 2020-05-16 15:01:30 +00:00
cmd-respawn-window.c Make client -c and -t handling common in cmd-queue.c and try to be 2020-04-13 20:51:57 +00:00
cmd-rotate-window.c Move cmdq_state into cmd-queue.c. 2020-04-13 14:46:04 +00:00
cmd-run-shell.c Drop support for popups where the content is provided directly to tmux 2021-03-02 10:56:45 +00:00
cmd-save-buffer.c Merge branch 'obsd-master' into master 2021-02-17 09:58:12 +00:00
cmd-select-layout.c Also move cmdq_item and cmdq_list into cmd-queue.c (this is to make its 2020-04-13 10:59:58 +00:00
cmd-select-pane.c Redraw status line and borders on pane enable/disable, GitHub issue 2554. 2021-02-04 14:02:24 +00:00
cmd-select-window.c Client could be NULL in select-window (for example in .tmux.conf), do 2020-10-29 13:47:40 +00:00
cmd-send-keys.c Fix ASCII keys with send-keys -l. 2020-05-27 14:45:35 +00:00
cmd-set-buffer.c Add a -w flag to set- and load-buffer to send to clipboard using OSC 52. 2020-09-02 13:46:35 +00:00
cmd-set-environment.c Add -F to set-environment and source-file; GitHub issue 2359. 2020-09-01 09:19:01 +00:00
cmd-set-option.c Make synchronize-panes a pane option and add -U flag to set-option to 2020-12-15 08:31:50 +00:00
cmd-show-environment.c Also move cmdq_item and cmdq_list into cmd-queue.c (this is to make its 2020-04-13 10:59:58 +00:00
cmd-show-messages.c Move lazy resize from the pane to the window, there is no point in 2020-05-16 16:50:55 +00:00
cmd-show-options.c Merge branch 'obsd-master' into master 2020-12-28 12:01:21 +00:00
cmd-source-file.c Merge branch 'obsd-master' 2020-09-01 12:01:20 +01:00
cmd-split-window.c Add a client flag 'active-pane' which stores the active pane in the 2020-05-16 16:20:59 +00:00
cmd-swap-pane.c Add a client flag 'active-pane' which stores the active pane in the 2020-05-16 16:20:59 +00:00
cmd-swap-window.c Also move cmdq_item and cmdq_list into cmd-queue.c (this is to make its 2020-04-13 10:59:58 +00:00
cmd-switch-client.c Change how panes are resized so that the code is clearer and if the pane 2020-06-05 11:20:51 +00:00
cmd-unbind-key.c Add -q flag to unbind-key to hide errors, GitHub issue 2381. 2020-09-16 19:12:59 +00:00
cmd-wait-for.c Also move cmdq_item and cmdq_list into cmd-queue.c (this is to make its 2020-04-13 10:59:58 +00:00
cmd.c Replace TAILQ concatenation loop with TAILQ_CONCAT 2020-07-03 12:02:37 +01:00
colour.c Support X11 colour names and some other variations for OSC 10/11, also 2021-02-15 09:39:37 +00:00
compat.h Add compat clock_gettime for older macOS. GitHub issue 2555. 2021-02-05 11:01:21 +00:00
configure.ac Add compat clock_gettime for older macOS. GitHub issue 2555. 2021-02-05 11:01:21 +00:00
control-notify.c Change so that window_flags escapes # automatically which means configs 2021-01-20 07:16:54 +00:00
control.c Look for libevent2 differently from libevent for platforms with both. 2021-01-17 17:21:51 +00:00
COPYING There is no examples directory anymore. 2019-03-26 15:10:05 +00:00
environ.c Allow fnmatch(3) wildcards in update-environment, GitHub issue 2397. 2020-10-07 08:23:55 +00:00
example_tmux.conf -attr -> -style. 2019-05-06 21:57:32 +01:00
file.c Merge branch 'obsd-master' into master 2021-02-17 09:58:12 +00:00
format-draw.c Make replacement of ##s consistent when drawing formats, whether 2020-12-01 08:12:58 +00:00
format.c Merge branch 'obsd-master' into master 2021-03-02 12:01:25 +00:00
grid-reader.c Move jump commands to grid reader, make them UTF-8 aware, and tidy up, 2021-02-22 06:53:04 +00:00
grid-view.c Move the code to set up a padding cell into grid.c. 2020-06-02 20:51:46 +00:00
grid.c Merge branch 'obsd-master' into master 2021-02-05 14:01:23 +00:00
input-keys.c Merge branch 'obsd-master' into master 2020-11-17 10:01:22 +00:00
input.c Reduce len when moving past spaces in OSC 11 parameter. 2021-02-18 13:30:24 +00:00
job.c Merge branch 'obsd-master' into master 2021-03-02 12:01:25 +00:00
key-bindings.c Fix note for "previous-window" default key binding, from Sebastian 2020-10-29 13:47:50 +00:00
key-string.c Always send xterm-style keys for M-Left and M-Right. GitHub issue 2296. 2020-07-06 07:27:39 +00:00
layout-custom.c Make a best effort to set xpixel and ypixel for each pane and add 2019-11-28 09:45:15 +00:00
layout-set.c Change so main-pane-width and height can be given as a percentage. 2020-04-22 06:57:13 +00:00
layout.c Simplify code to work out if an extra line is needed in the cell. 2019-07-15 18:43:32 +00:00
log.c Merge branch 'obsd-master' 2019-09-25 00:01:25 +01:00
Makefile.am Add -Wno-format-y2k. 2021-01-18 11:14:37 +00:00
mdoc2man.awk Generate tmux.1 using mdoc2man.awk on Solaris, issue brought up and changes 2013-04-16 11:33:53 +01:00
menu.c Do not allow disabled items to be selected. 2020-10-30 12:00:01 +00:00
mode-tree.c Add a -d option to display-message to set delay, from theonekeyg at 2020-07-27 08:03:10 +00:00
names.c Do not use NULL active window; also do not leak window name. GitHub 2021-03-02 11:00:38 +00:00
notify.c Merge branch 'obsd-master' 2020-05-21 08:55:31 +01:00
options-table.c Merge branch 'obsd-master' into master 2021-02-01 10:01:20 +00:00
options.c Hide some warnings on newer GCC versions, GitHUb issue 2525. 2021-01-18 11:14:23 +00:00
osdep-aix.c Update my email address. 2016-01-19 18:07:25 +00:00
osdep-cygwin.c Look for libevent2 differently from libevent for platforms with both. 2021-01-17 17:21:51 +00:00
osdep-darwin.c +compat.h 2021-01-17 17:52:10 +00:00
osdep-dragonfly.c Look for libevent2 differently from libevent for platforms with both. 2021-01-17 17:21:51 +00:00
osdep-freebsd.c Look for libevent2 differently from libevent for platforms with both. 2021-01-17 17:21:51 +00:00
osdep-haiku.c Look for libevent2 differently from libevent for platforms with both. 2021-01-17 17:21:51 +00:00
osdep-hpux.c Look for libevent2 differently from libevent for platforms with both. 2021-01-17 17:21:51 +00:00
osdep-linux.c Look for libevent2 differently from libevent for platforms with both. 2021-01-17 17:21:51 +00:00
osdep-netbsd.c Look for libevent2 differently from libevent for platforms with both. 2021-01-17 17:21:51 +00:00
osdep-openbsd.c Look for libevent2 differently from libevent for platforms with both. 2021-01-17 17:21:51 +00:00
osdep-sunos.c Look for libevent2 differently from libevent for platforms with both. 2021-01-17 17:21:51 +00:00
osdep-unknown.c Look for libevent2 differently from libevent for platforms with both. 2021-01-17 17:21:51 +00:00
paste.c Use VIS_CSTYLE for paste buffers also. 2020-05-16 15:35:19 +00:00
popup.c Merge branch 'obsd-master' into master 2021-03-02 12:01:25 +00:00
proc.c Merge branch 'obsd-master' into master 2021-02-17 09:58:12 +00:00
README Also pkg-config. 2020-09-30 13:27:25 +01:00
README.ja Japanese README from Kohei Takada. 2018-07-04 10:47:14 +01:00
regsub.c Some minor style nits. 2020-04-09 14:23:34 +00:00
resize.c Tidy the resize code, merge some common bits and add some comments. From 2020-10-05 10:00:51 +00:00
screen-redraw.c Send Unicode directional isolate characters around horizontal pane 2021-02-05 12:29:18 +00:00
screen-write.c Trim output overwritten by later text or clears completely rather than 2021-01-29 09:48:43 +00:00
screen.c Merge branch 'obsd-master' into master 2021-01-26 10:01:18 +00:00
server-client.c Merge branch 'obsd-master' into master 2021-02-17 09:58:51 +00:00
server-fn.c Merge branch 'obsd-master' into master 2021-02-01 10:01:20 +00:00
server.c Merge branch 'obsd-master' into master 2021-02-17 09:58:12 +00:00
session.c remove vis.h: portable doesn't need this 2020-05-16 18:42:53 +01:00
spawn.c Merge branch 'obsd-master' into master 2021-03-02 12:01:25 +00:00
status.c Move jump commands to grid reader, make them UTF-8 aware, and tidy up, 2021-02-22 06:53:04 +00:00
style.c Add a customize mode where keys and options may be browsed and changed, 2020-05-16 16:02:24 +00:00
SYNCING Update release text. 2017-05-29 08:40:33 +01:00
tmux.1 Merge branch 'obsd-master' into master 2021-03-02 12:01:25 +00:00
tmux.c Merge branch 'obsd-master' into master 2021-02-22 12:01:18 +00:00
tmux.h Merge branch 'obsd-master' into master 2021-03-02 12:01:25 +00:00
tty-acs.c Add an option to set the pane border lines style from a choice of single 2020-05-16 16:26:34 +00:00
tty-features.c Use the setal capability as well as (tmux's) Setulc. 2020-10-05 09:53:01 +00:00
tty-keys.c Old Terminal.app versions do not respond correctly to secondary DA, 2020-09-30 13:33:02 +01:00
tty-term.c Reinstate del_curterm ifdef bits. 2021-03-01 10:51:24 +00:00
tty.c Move the call to setupterm() into the client and have it pass the 2021-02-17 07:18:36 +00:00
utf8.c Restore utf8proc bits that went missing, GitHub issue 2564. 2021-02-10 17:18:37 +00:00
window-buffer.c Merge branch 'obsd-master' into master 2020-12-03 08:01:22 +00:00
window-client.c Redraw any visible modes when status line changes so that formats like 2020-12-03 07:12:11 +00:00
window-clock.c Do not hoke into struct window_pane from the tty code and instead set 2020-05-16 15:34:08 +00:00
window-copy.c Drop support for popups where the content is provided directly to tmux 2021-03-02 10:56:45 +00:00
window-customize.c Hide some warnings on newer GCC versions, GitHUb issue 2525. 2021-01-18 11:14:23 +00:00
window-tree.c Merge branch 'obsd-master' into master 2020-12-03 08:01:22 +00:00
window.c Merge branch 'obsd-master' into master 2021-02-22 08:01:22 +00:00
xmalloc.c Add xrecallocarray. 2019-11-28 09:51:58 +00:00
xmalloc.h Merge branch 'obsd-master' 2019-11-28 12:18:41 +00:00

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, OS X and Solaris.

* Dependencies

tmux depends on libevent 2.x, available from:

	https://github.com/libevent/libevent/releases/latest

It also depends on ncurses, available from:

	https://invisible-mirror.net/archives/ncurses/

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 https://github.com/tmux/tmux.git
	$ cd tmux
	$ 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.com

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.

A bash(1) completion file is at:

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

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:

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

Subscribe by sending an email to:

	tmux-users+subscribe@googlegroups.com

* 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.