Go to file
Nicholas Marriott d0fa520788 Update CHANGES. 2020-04-27 09:38:04 +01:00
.github Add GitHub. 2020-02-19 06:01:54 +00:00
compat Missing headers from compat/asprintf.c, from cyyever at outlook dot com. 2019-09-08 21:29:22 +01: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 Add a config. 2019-06-18 19:42:52 +01:00
tools Fix gseq use in RGB colour script. 2019-04-28 22:16:34 +01:00
.gitignore Add yacc(1) bits. 2019-05-23 15:11:25 +01:00
.mailmap Add to .mailmap. 2016-07-19 10:42:44 +01:00
.travis.yml Update .travis.yml from master. 2019-05-29 14:40:41 +01:00
CHANGES Update CHANGES. 2020-04-27 09:38:04 +01:00
COPYING There is no examples directory anymore. 2019-03-26 15:10:05 +00:00
Makefile.am Fix for version changes. 2020-01-28 11:28:30 +00:00
README cc, make, libevent, ncurses are dependencies for all builds so no need to list 2019-07-17 08:57:22 +01:00
README.ja Japanese README from Kohei Takada. 2018-07-04 10:47:14 +01:00
SYNCING Update release text. 2017-05-29 08:40:33 +01:00
alerts.c Redrawing status is needed after changing window flags or title does not 2017-12-28 12:10:50 +00:00
arguments.c getopt is not required to set optarg to NULL when there is no argument 2020-03-18 07:54:37 +00:00
attributes.c Style nits in function arguments. 2019-12-03 10:47:22 +00:00
autogen.sh Bump automake and autoconf versions. 2017-03-22 08:45:53 +00:00
cfg.c Merge branch 'obsd-master' 2019-12-19 10:01:26 +00:00
client.c Do not close stdout file descriptor in control mode since it will be needed for 2020-04-27 09:36:30 +01:00
cmd-attach-session.c If a window appears in only one attached session, there is no point in 2019-11-29 16:04:07 +00:00
cmd-bind-key.c Remove bind-key -c which doesn't do anything and is undocumented. 2020-01-30 08:02:25 +00:00
cmd-break-pane.c Make a best effort to set xpixel and ypixel for each pane and add 2019-11-28 09:45:15 +00:00
cmd-capture-pane.c Rewrite the code for reading and writing files. Now, if the client is 2019-12-12 11:39:56 +00:00
cmd-choose-tree.c Add a flag to reverse sort in the various choose modes, from Benjamin 2019-08-16 11:49:12 +00:00
cmd-command-prompt.c Add support for adding a note to a key binding (with bind-key -N) and 2020-01-27 08:53:13 +00:00
cmd-confirm-before.c Replace the split parser code (cfg.c and cmd-string.c) with a single 2019-05-23 11:13:30 +00:00
cmd-copy-mode.c Various fixes for copy mode from master. 2020-04-06 16:09:49 +01:00
cmd-detach-client.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-display-menu.c Change display-menu from taking a single string to a set of arguments, 2019-05-28 07:18:42 +00:00
cmd-display-message.c Remove a leftover abort and some fixes from cppcheck. 2019-05-30 20:54:03 +00:00
cmd-display-panes.c Pass keys that aren't 0-9 on to normal key processing when display-panes 2019-06-27 15:49:43 +01:00
cmd-find-window.c Add -r to find-window for regex instead of fnmatch. 2019-06-20 20:31:04 +00:00
cmd-find.c Merge branch 'obsd-master' 2019-06-12 11:02:25 +01:00
cmd-if-shell.c Use the right client for if -b. 2019-07-17 17:49:23 +00:00
cmd-join-pane.c Merge branch 'obsd-master' 2020-01-02 14:01:26 +00:00
cmd-kill-pane.c Fix parsing of DA with only one argument in the response and add 65 for VT520. 2019-11-14 15:37:19 +00:00
cmd-kill-server.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-kill-session.c Break new window and pane creation common code from various commands and 2019-04-17 14:37:48 +00:00
cmd-kill-window.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-list-buffers.c In order that people can use formats like #D in #() in the status line 2017-05-01 12:20:55 +00:00
cmd-list-clients.c In order that people can use formats like #D in #() in the status line 2017-05-01 12:20:55 +00:00
cmd-list-keys.c Add an argument to list-commands to show only a single command. 2020-04-06 16:03:39 +01:00
cmd-list-panes.c In order that people can use formats like #D in #() in the status line 2017-05-01 12:20:55 +00:00
cmd-list-sessions.c Support for windows larger than visible on the attached client. This has 2018-10-18 08:38:01 +00:00
cmd-list-windows.c In order that people can use formats like #D in #() in the status line 2017-05-01 12:20:55 +00:00
cmd-load-buffer.c Rewrite the code for reading and writing files. Now, if the client is 2019-12-12 11:39:56 +00:00
cmd-lock-server.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-move-window.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-new-session.c Use new window and new pane as well for -P to new-session or new-window. 2020-04-06 16:03:33 +01:00
cmd-new-window.c Use new window and new pane as well for -P to new-session or new-window. 2020-04-06 16:03:33 +01:00
cmd-parse.y Ignore empty commands rather than adding them to the command list rather 2020-01-28 13:10:14 +00:00
cmd-paste-buffer.c Merge branch 'obsd-master' 2017-04-22 12:01:19 +01:00
cmd-pipe-pane.c Merge branch 'obsd-master' 2019-03-18 15:07:51 +00:00
cmd-queue.c Stop logging the entire command queue every time we add something, 2020-04-06 16:04:10 +01:00
cmd-refresh-client.c Store xpixel/ypixel from TIOCGWINSZ and add formats. 2019-11-28 09:05:34 +00:00
cmd-rename-session.c Allow no client for rename-session, from Ryan Freeman. 2018-04-11 09:54:45 +00:00
cmd-rename-window.c Fix a regression: do not warn about no client in rename-window. 2018-03-23 19:17:03 +00:00
cmd-resize-pane.c Add support for percentage sizes for resize-pane ("-x 10%"). Also change 2019-10-15 08:25:37 +00:00
cmd-resize-window.c Make a best effort to set xpixel and ypixel for each pane and add 2019-11-28 09:45:15 +00:00
cmd-respawn-pane.c Support multiple occurances of the same argument. Use this for a new 2019-04-28 20:05:50 +00:00
cmd-respawn-window.c Add a "latest" window-size option which tries to size windows based on 2019-09-19 09:02:30 +00:00
cmd-rotate-window.c Add -Z flag to rotate-window, select-pane, swap-pane, switch-client to 2019-08-14 09:58:31 +00:00
cmd-run-shell.c Add a cmdq_continue function rather than twiddling the flag directly. 2019-06-18 11:08:42 +00:00
cmd-save-buffer.c Merge branch 'obsd-master' 2019-12-12 14:33:47 +00:00
cmd-select-layout.c Set the window size as well as the layout size when using the preset 2019-04-17 14:43:49 +00:00
cmd-select-pane.c Instead of passing titles through vis() which doubles backslashes, just 2020-02-03 13:46:27 +00:00
cmd-select-window.c Merge hooks into options and make each one an array option. This allows 2019-04-26 11:38:51 +00:00
cmd-send-keys.c Treat plausible but invalid keys (like C-BSpace) as literal like any 2020-01-13 07:51:54 +00:00
cmd-set-buffer.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-set-environment.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-set-option.c Add a per-pane option set. Pane options inherit from window options (so 2019-06-20 11:59:59 +00:00
cmd-show-environment.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-show-messages.c Merge branch 'obsd-master' 2018-08-23 19:02:40 +01:00
cmd-show-options.c Merge branch 'obsd-master' 2019-06-20 17:02:26 +01:00
cmd-source-file.c Merge branch 'obsd-master' 2019-12-21 18:01:24 +00:00
cmd-split-window.c Do not attempt to close a NULL pane when failing to create a new one. 2020-03-17 16:14:25 +00:00
cmd-swap-pane.c Add -Z flag to rotate-window, select-pane, swap-pane, switch-client to 2019-08-14 09:58:31 +00:00
cmd-swap-window.c Fix swap-window -d to work as intended, GitHub issue 1879 from Sam Stuewe. 2019-09-16 08:59:36 +01:00
cmd-switch-client.c Update latest client for target session on switch-client. 2020-03-06 15:35:03 +00:00
cmd-unbind-key.c Bad merge. 2017-01-25 16:38:13 +00:00
cmd-wait-for.c Add a cmdq_continue function rather than twiddling the flag directly. 2019-06-18 11:08:42 +00:00
cmd.c Merge branch 'obsd-master' 2020-01-04 20:01:26 +00:00
colour.c Add support for underscore colours with Setulc capability, mostly from 2019-06-27 15:17:41 +00:00
compat.h getopt varies too much between platforms, and we already use compat/getopt.c 2020-03-17 16:14:12 +00:00
configure.ac Do not close stdout file descriptor in control mode since it will be needed for 2020-04-27 09:36:30 +01:00
control-notify.c Terminate the output buffer for control mode output - it is now used as 2020-03-17 16:14:51 +00:00
control.c Rewrite the code for reading and writing files. Now, if the client is 2019-12-12 11:39:56 +00:00
environ.c options_array_item_value cannot return NULL. 2019-04-25 19:36:59 +00:00
example_tmux.conf -attr -> -style. 2019-05-06 21:57:32 +01:00
file.c Remove imsg.h. 2019-12-16 20:01:26 +00:00
format-draw.c Use correct width of right marker so it doesn't draw over status right 2020-03-07 10:58:32 +00:00
format.c Merge branch 'obsd-master' 2020-02-14 16:01:26 +00:00
grid-view.c grid_view_delete_cells does need to clear, GitHub issue 1871. 2019-08-16 19:34:29 +01:00
grid.c Style nits in function arguments. 2019-12-03 10:47:22 +00:00
input-keys.c Merge branch 'obsd-master' 2020-01-13 10:01:27 +00:00
input.c Instead of passing titles through vis() which doubles backslashes, just 2020-02-03 13:46:27 +00:00
job.c Merge branch 'obsd-master' 2019-06-28 17:02:26 +01:00
key-bindings.c Add support for adding a note to a key binding (with bind-key -N) and 2020-01-27 08:53:13 +00:00
key-string.c Fix C-Space key string. 2020-03-17 16:16:09 +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 Make a best effort to set xpixel and ypixel for each pane and add 2019-11-28 09:45:15 +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
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 Change menu key bindings to Up and Down and also close it on any mouse 2019-09-25 15:56:30 +01:00
mode-tree.c Do not crash in tree modes if the pane is only 1 in width, reported by 2019-12-12 15:03:13 +00:00
names.c Allow ispunct() as well as isalnum() when parsing initial window names. 2017-07-21 12:58:02 +00:00
notify.c Merge branch 'obsd-master' 2019-12-19 10:01:26 +00:00
options-table.c Missing after-kill-pane option. 2019-11-28 12:22:32 +00:00
options.c Style nits in function arguments. 2019-12-03 10:47:22 +00:00
osdep-aix.c Update my email address. 2016-01-19 18:07:25 +00:00
osdep-cygwin.c Update my email address. 2016-01-19 18:07:25 +00:00
osdep-darwin.c Warning fixes from Carlo Marcelo Arenas Belón. 2019-04-10 19:27:09 +01:00
osdep-dragonfly.c Update my email address. 2016-01-19 18:07:25 +00:00
osdep-freebsd.c Fixes for GNU/kFreeBSD from James Clarke. 2018-11-21 08:50:22 +00:00
osdep-hpux.c Update my email address. 2016-01-19 18:07:25 +00:00
osdep-linux.c Remove EVENT_* variables from environment after initializing libevent so they 2018-03-21 08:15:15 +00:00
osdep-netbsd.c Use KERN_PROC_CWD on NetBSD, from Leonardo Taccari. 2019-06-20 06:57:37 +01:00
osdep-openbsd.c Merge branch 'obsd-master' 2016-10-12 09:45:49 +01:00
osdep-sunos.c Some __unused. 2017-03-21 19:27:18 +00:00
osdep-unknown.c Update my email address. 2016-01-19 18:07:25 +00:00
paste.c Merge branch 'obsd-master' 2019-04-02 11:02:44 +01:00
proc.c Merge branch 'obsd-master' 2020-01-28 11:17:08 +00:00
regsub.c REG_STARTEND is not portable, but it turns out we don't actually need 2019-12-01 08:52:47 +00:00
resize.c If ALL clients are readonly, allow them to affect the size, suggested by Thomas Sattler. 2020-01-28 13:23:24 +00:00
screen-redraw.c Mark pane status line jobs with FORMAT_STATUS also so it redraws when 2019-07-24 21:16:17 +00:00
screen-write.c Parse out DA features. 2019-11-28 10:17:22 +00:00
screen.c Make list-keys description clearer in tmux.1 and remove an unused variable. 2020-02-06 12:49:02 +00:00
server-client.c Merge branch 'obsd-master' 2020-02-19 16:01:27 +00:00
server-fn.c Merge branch 'obsd-master' 2019-12-12 14:33:47 +00:00
server.c Merge branch 'obsd-master' 2019-06-20 09:02:26 +01:00
session.c Merge branch 'obsd-master' 2019-12-26 12:01:26 +00:00
spawn.c Merge branch 'obsd-master' 2020-03-02 23:09:48 +00:00
status.c Add support for adding a note to a key binding (with bind-key -N) and 2020-01-27 08:53:13 +00:00
style.c Add push-default and pop-default in styles to change the default colours 2019-09-15 21:42:57 +00:00
tmux.1 Various fixes for copy mode from master. 2020-04-06 16:09:49 +01:00
tmux.c -V also needs to go in usage. 2020-01-28 11:31:31 +00:00
tmux.h Add non-regex search variants to avoid the performance cost for people 2020-04-01 10:08:09 +01:00
tty-acs.c Change a couple of ACS characters to be more sensible and add a few 2019-05-17 05:48:25 +00:00
tty-keys.c If we can identify the terminal as iTerm2 or as tmux, we can be sure 2020-01-28 11:39:51 +00:00
tty-term.c Merge branch 'obsd-master' 2020-01-28 12:01:28 +00:00
tty.c Turn off mouse mode 1003 as well as the rest when exiting. 2020-03-17 16:16:23 +00:00
utf8.c Merge branch 'obsd-master' 2019-11-25 16:01:27 +00:00
window-buffer.c Merge branch 'obsd-master' 2020-02-11 08:01:30 +00:00
window-client.c Add a define for flags meaning a client is not attached, and fix 2020-01-28 08:06:11 +00:00
window-clock.c DECRC and DECSC apparently need to preserve origin mode as well, based 2019-03-12 20:02:47 +00:00
window-copy.c job_run needs fewer arguments. 2020-04-06 16:14:09 +01:00
window-tree.c Merge branch 'obsd-master' 2020-01-08 08:01:24 +00:00
window.c Merge branch 'obsd-master' 2020-02-14 16:01:26 +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
xterm-keys.c Up to now, tmux sees \033\033[OA as M-Up and since we turned on 2017-05-07 21:25:59 +00:00

README

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/

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