Go to file
Nicholas Marriott caa90735cf 2.5. 2017-05-29 08:12:25 +01:00
compat getptmfd() and fdforkpty() compat. 2017-04-20 19:09:07 +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 Fix test. 2017-05-09 23:01:10 +01:00
tools Copy 24-bit-color.sh from iTerm2. 2017-02-15 10:34:20 +00:00
.gitignore Add *.dSYM for OS X. 2016-06-15 09:51:08 +01:00
.mailmap Add to .mailmap. 2016-07-19 10:42:44 +01:00
.travis.yml TRAVIS-CI: correct path to configure 2015-05-17 14:39:04 +01:00
CHANGES Reset updated flag when restarting job so new output is detected, reported by 2017-05-13 08:16:11 +01:00
CONTRIBUTING Give an example, from Timothee Cour. 2017-02-08 11:52:42 +00:00
COPYING Add a COPYING file, suggested by Dagobert Michelsen. 2013-05-31 12:59:17 +01:00
FAQ Expand on OS X faffing, based on a diff from Kurtis Rader. 2017-03-06 09:24:41 +00:00
ISSUE_TEMPLATE This link is better. 2017-01-26 19:57:16 +00:00
Makefile.am Fix after merge 2017-04-21 09:29:22 +01:00
README Clarify that release instructions will install. 2017-03-18 08:33:15 +00:00
SYNCING Turn on debug if $VERSION is master rather than commenting and uncommenting. 2017-04-20 12:06:39 +01:00
TODO Update TODO. 2017-05-09 22:33:39 +01:00
alerts.c Log what is happening with window and session reference counts much more 2017-04-28 19:13:55 +00:00
arguments.c Do not need getopt.h. 2017-04-22 12:08:41 +00:00
attributes.c Add support for the strikethrough attribute (SGR 9), using the new smxx 2017-03-22 07:16:54 +00:00
autogen.sh Bump automake and autoconf versions. 2017-03-22 08:45:53 +00:00
cfg.c Merge branch 'obsd-master' 2017-05-01 14:01:14 +01:00
client.c Merge branch 'obsd-master' 2017-01-24 22:01:13 +00:00
cmd-attach-session.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-bind-key.c Bad merge. 2017-01-25 16:38:13 +00:00
cmd-break-pane.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-capture-pane.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-choose-buffer.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-choose-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-choose-tree.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-command-prompt.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-confirm-before.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-copy-mode.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-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-message.c In order that people can use formats like #D in #() in the status line 2017-05-01 12:20:55 +00:00
cmd-display-panes.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-find-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-find.c Merge branch 'obsd-master' 2017-04-22 14:01:15 +01:00
cmd-if-shell.c if-shell doesn't need to queue its error message into a callback, and in 2017-04-25 11:49:35 +00:00
cmd-join-pane.c Merge branch 'obsd-master' 2017-04-22 12:01:19 +01:00
cmd-kill-pane.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-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 Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +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 In order that people can use formats like #D in #() in the status line 2017-05-01 12:20:55 +00: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 In order that people can use formats like #D in #() in the status line 2017-05-01 12:20:55 +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-list.c I no longer use my SourceForge address so replace it. 2016-01-19 15:59:12 +00:00
cmd-load-buffer.c Memory leaks, from David CARLIER. 2017-04-22 06:13:30 +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 new -A should use the session name. 2017-04-22 10:26:44 +00:00
cmd-new-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-paste-buffer.c Merge branch 'obsd-master' 2017-04-22 12:01:19 +01:00
cmd-pipe-pane.c Merge branch 'obsd-master' 2017-05-01 14:01:14 +01:00
cmd-queue.c In order that people can use formats like #D in #() in the status line 2017-05-01 12:20:55 +00:00
cmd-refresh-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-rename-session.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-rename-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-resize-pane.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-respawn-pane.c Do not update TERM into config file parsing has finished. 2017-04-25 15:35:10 +00:00
cmd-respawn-window.c Do not update TERM into config file parsing has finished. 2017-04-25 15:35:10 +00:00
cmd-rotate-window.c Set current pane in rotate-window. 2017-05-09 11:00:48 +00:00
cmd-run-shell.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-save-buffer.c Merge branch 'obsd-master' 2017-04-22 08:01:54 +01:00
cmd-select-layout.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-select-pane.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-select-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-send-keys.c If the target pane for send-keys in in a mode with a key table (that is, 2017-05-09 17:56:55 +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-hook.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 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-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' 2017-04-22 12:01:19 +01:00
cmd-show-options.c Merge branch 'obsd-master' 2017-04-22 12:01:19 +01:00
cmd-source-file.c load_cfg returns < 0 on error, not != 0. Problem reported by Kaushal Modi. 2017-04-19 22:19:22 +01:00
cmd-split-window.c Merge branch 'obsd-master' 2017-04-25 18:01:11 +01:00
cmd-string.c Add support for custom command aliases, this is an array option which 2017-01-24 19:53:37 +00:00
cmd-swap-pane.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-swap-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-switch-client.c Some new notifications, mainly for active pane and current window and 2017-05-04 07:16:43 +00:00
cmd-unbind-key.c Bad merge. 2017-01-25 16:38:13 +00:00
cmd-wait-for.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd.c Merge branch 'obsd-master' 2017-04-22 12:01:19 +01:00
colour.c Show count of search results in copy mode. 2017-03-24 07:14:27 +00:00
compat.h Do not need getopt.h for getopt, from Eric N Vander Weele. 2017-04-20 20:35:11 +01:00
configure.ac 2.5. 2017-05-29 08:12:25 +01:00
control-notify.c Some new notifications, mainly for active pane and current window and 2017-05-04 07:16:43 +00:00
control.c It is silly for cmd_list_parse to return an integer error when it could 2017-01-15 22:00:56 +00:00
environ.c Do not update TERM into config file parsing has finished. 2017-04-25 15:35:10 +00:00
example_tmux.conf 15 minutes is not 1800 seconds, but just remove lock-after-time because it won't work for Linux folks without additional configuration 2017-01-10 19:33:22 +00:00
format.c Reset updated flag when restarting job so new output is detected, reported by 2017-05-13 08:16:11 +01:00
grid-view.c Handle insert cells when cursor at edge of screen correctly, and do a 2017-02-16 12:43:08 +00:00
grid.c ECH needs to use background colour. 2017-05-12 16:16:16 +01:00
hooks.c Provide a way for hooks to tag formats onto the commands they fire so 2016-10-16 19:36:37 +00:00
input-keys.c Merge branch 'obsd-master' 2017-05-09 15:44:13 +01:00
input.c ECH needs to use background colour. 2017-05-12 16:16:16 +01:00
job.c Merge branch 'obsd-master' 2017-04-25 18:01:11 +01:00
key-bindings.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
key-string.c Minor bits: fix an array size, add comment, make grid_cell_entry static. 2017-02-22 09:01:32 +00:00
layout-custom.c Use the notify name string instead of going via an enum and change 2016-10-16 22:06:40 +00:00
layout-set.c Some other stuff that can be local to one file. 2016-10-11 13:45:47 +00:00
layout.c Fix calculation of size for full size splits. 2017-03-11 15:16:35 +00:00
log.c Merge branch 'obsd-master' 2017-02-05 02:01:12 +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
names.c In order that people can use formats like #D in #() in the status line 2017-05-01 12:20:55 +00:00
notify.c Merge branch 'obsd-master' 2017-05-04 10:01:12 +01:00
options-table.c Merge branch 'obsd-master' 2017-01-24 22:01:13 +00:00
options.c Memory leaks, from David CARLIER. 2017-04-22 06:13:30 +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 Apple have changed their API again, from Gregory Pakosz. 2016-09-12 11:06:35 +01:00
osdep-dragonfly.c Update my email address. 2016-01-19 18:07:25 +00:00
osdep-freebsd.c Update my email address. 2016-01-19 18:07:25 +00:00
osdep-hpux.c Update my email address. 2016-01-19 18:07:25 +00:00
osdep-linux.c Update my email address. 2016-01-19 18:07:25 +00:00
osdep-netbsd.c Improve NetBSD KERN_PROC2 bit, mostly from Kamil Rytarowski. 2017-02-19 08:31:05 +00: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' 2017-01-24 14:01:15 +00:00
proc.c Put version in log in portable tmux. 2017-01-18 17:35:41 +00:00
resize.c Improve some of the logging on resize. 2017-02-08 13:53:32 +00:00
screen-redraw.c In order that people can use formats like #D in #() in the status line 2017-05-01 12:20:55 +00:00
screen-write.c ECH needs to use background colour. 2017-05-12 16:16:16 +01:00
screen.c Collect sequences of printable ASCII characters and process them 2017-02-08 16:45:18 +00:00
server-client.c Merge branch 'obsd-master' 2017-05-09 15:44:33 +01:00
server-fn.c Merge branch 'obsd-master' 2017-04-17 10:01:13 +01:00
server.c Merge branch 'obsd-master' 2017-04-22 08:01:54 +01:00
session.c Merge branch 'obsd-master' 2017-05-04 10:01:12 +01:00
signal.c Loads more static, except for cmd-*.c and window-*.c. 2016-10-10 21:29:23 +00:00
status.c Add a format for the last search string in copy mode and fix the prompt 2017-05-03 05:53:34 +00:00
style.c Add support for the strikethrough attribute (SGR 9), using the new smxx 2017-03-22 07:16:54 +00:00
tmux.1 Merge branch 'obsd-master' 2017-05-09 15:44:13 +01:00
tmux.c Do not need getopt.h. 2017-04-22 12:08:41 +00:00
tmux.h ECH needs to use background colour. 2017-05-12 16:16:16 +01:00
tty-acs.c Remove some dead code in cmd-move-window.c and make a load of local 2016-10-03 22:52:11 +00:00
tty-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
tty-term.c Merge branch 'obsd-master' 2017-03-22 08:01:17 +00:00
tty.c ECH needs to use background colour. 2017-05-12 16:16:16 +01:00
utf8.c Bad merge. 2017-03-21 14:48:44 +00:00
window-choose.c Add a format for the name of the pane's mode, lets it be used as a 2017-05-07 22:27:57 +00:00
window-clock.c Add a format for the name of the pane's mode, lets it be used as a 2017-05-07 22:27:57 +00:00
window-copy.c Add a format for the name of the pane's mode, lets it be used as a 2017-05-07 22:27:57 +00:00
window.c Merge branch 'obsd-master' 2017-05-04 10:01:12 +01:00
xmalloc.c Key running commands for #() by the unexpanded command, and run them 2016-11-17 10:06:08 +00:00
xmalloc.h Merge branch 'obsd-master' 2016-11-17 12:01:10 +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 (or windows)
to be accessed and controlled from a single terminal. tmux is intended to be a
simple, modern, BSD-licensed alternative to programs such as GNU screen.

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

tmux depends on libevent 2.x. Download it from:

	http://libevent.org

It also depends on ncurses, available from:

	http://invisible-island.net/ncurses/

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:

	$ git clone https://github.com/tmux/tmux.git
	$ cd tmux
	$ sh autogen.sh
	$ ./configure && make

For more information see http://git-scm.com. Patches should be sent by email to
the mailing list at tmux-users@googlegroups.com.

For documentation on using tmux, see the tmux.1 manpage. It can be viewed from
the source tree with:

	$ nroff -mdoc tmux.1|less

Some common questions are answered in the FAQ file, a rough todo list is in the
TODO file and an example configuration in example_tmux.conf.

A vim(1) syntax file is available at:

	https://github.com/ericpruitt/tmux.vim
	https://raw.githubusercontent.com/ericpruitt/tmux.vim/master/vim/syntax/tmux.vim

And a bash(1) completion file at:

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

For debugging, running tmux with -v or -vv will generate server and client log
files in the current directory.

tmux mailing lists are available. For general discussion and bug reports:

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

And for Git commit emails:

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

Subscribe by sending an email to <tmux-users+subscribe@googlegroups.com>.

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

	tmux-users@googlegroups.com

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

-- Nicholas Marriott <nicholas.marriott@gmail.com>