Go to file
Nicholas Marriott c3dbbdaadf Bump automake and autoconf versions. 2017-03-22 08:45:53 +00:00
compat Some __unused. 2017-03-21 19:27:18 +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
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 Fix typos 2016-09-30 09:50:40 +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 DEFS -> AM_CPPFLAGS. 2017-03-22 07:54:30 +00:00
README Clarify that release instructions will install. 2017-03-18 08:33:15 +00:00
SYNCING Rename found_debug to enable_debug. 2016-10-18 20:19:24 +01:00
TODO Add to TODO. 2017-03-21 21:28:37 +00:00
alerts.c Clear window alert flags after setting winlink alert flags, fixes problem 2016-11-01 09:07:18 +00:00
arguments.c vis.h comes from compat.h. 2017-01-18 12:16:14 +00:00
attributes.c Style nits. 2017-02-16 10:53:25 +00:00
autogen.sh Bump automake and autoconf versions. 2017-03-22 08:45:53 +00:00
cfg.c Merge branch 'obsd-master' 2017-02-03 14:01:13 +00:00
client.c Merge branch 'obsd-master' 2017-01-24 22:01:13 +00:00
cmd-attach-session.c Add a helper function for the most common format_create/defaults/expand 2017-03-08 13:36:12 +00:00
cmd-bind-key.c Bad merge. 2017-01-25 16:38:13 +00:00
cmd-break-pane.c Add a helper function for the most common format_create/defaults/expand 2017-03-08 13:36:12 +00:00
cmd-capture-pane.c Merge clear-history into capture-pane. 2017-02-16 12:18:38 +00:00
cmd-choose-buffer.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-choose-client.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-choose-tree.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-command-prompt.c It is silly for cmd_list_parse to return an integer error when it could 2017-01-15 22:00:56 +00:00
cmd-confirm-before.c It is silly for cmd_list_parse to return an integer error when it could 2017-01-15 22:00:56 +00:00
cmd-copy-mode.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-detach-client.c Add -E to detach-client to exec a command to replace the client instead 2017-01-13 10:12:12 +00:00
cmd-display-message.c Add a window or pane id "tag" to each format tree and use it to separate 2017-02-03 11:57:27 +00:00
cmd-display-panes.c Move the client identify (display-panes) code into server-client.c. 2017-03-09 17:06:35 +00:00
cmd-find-window.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-find.c Merge branch 'obsd-master' 2017-03-13 12:01:13 +00:00
cmd-if-shell.c Add a helper function for the most common format_create/defaults/expand 2017-03-08 13:36:12 +00:00
cmd-join-pane.c Merge branch 'obsd-master' 2016-10-17 00:01:11 +01:00
cmd-kill-pane.c Redraw after killp -a. 2017-03-16 20:05:14 +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 Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-kill-window.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-list-buffers.c Add a window or pane id "tag" to each format tree and use it to separate 2017-02-03 11:57:27 +00:00
cmd-list-clients.c Add a window or pane id "tag" to each format tree and use it to separate 2017-02-03 11:57:27 +00:00
cmd-list-keys.c Add a window or pane id "tag" to each format tree and use it to separate 2017-02-03 11:57:27 +00:00
cmd-list-panes.c Add a window or pane id "tag" to each format tree and use it to separate 2017-02-03 11:57:27 +00:00
cmd-list-sessions.c Add a window or pane id "tag" to each format tree and use it to separate 2017-02-03 11:57:27 +00:00
cmd-list-windows.c Add a window or pane id "tag" to each format tree and use it to separate 2017-02-03 11:57:27 +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 Make source-file look for files relative to the client working directory 2017-02-14 18:13:05 +00:00
cmd-lock-server.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-move-window.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-new-session.c Add a helper function for the most common format_create/defaults/expand 2017-03-08 13:36:12 +00:00
cmd-new-window.c Add a helper function for the most common format_create/defaults/expand 2017-03-08 13:36:12 +00:00
cmd-paste-buffer.c Merge branch 'obsd-master' 2016-10-16 22:01:14 +01:00
cmd-pipe-pane.c Merge branch 'obsd-master' 2017-02-03 14:01:13 +00:00
cmd-queue.c Add a window or pane id "tag" to each format tree and use it to separate 2017-02-03 11:57:27 +00:00
cmd-refresh-client.c Minor tidying in a couple of commands. 2017-01-10 19:45:55 +00:00
cmd-rename-session.c Don't error if renaming a session to its current name, from shik dot 2016-11-16 11:41:17 +00:00
cmd-rename-window.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-resize-pane.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-respawn-pane.c Move server_fill_environ into environ.c and move some other common code 2017-03-09 17:02:38 +00:00
cmd-respawn-window.c Move server_fill_environ into environ.c and move some other common code 2017-03-09 17:02:38 +00:00
cmd-rotate-window.c rotate-window needs to unzoom, problem reported by Sean Haugh. 2016-11-14 16:27:12 +00:00
cmd-run-shell.c Add a helper function for the most common format_create/defaults/expand 2017-03-08 13:36:12 +00:00
cmd-save-buffer.c Merge branch 'obsd-master' 2017-02-14 20:01:12 +00:00
cmd-select-layout.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-select-pane.c The target validity check used window_pane_visible but that may be false 2016-11-16 00:24:03 +00:00
cmd-select-window.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-send-keys.c Add support for the OSC 4 and OSC 104 palette setting escape sequences, 2017-01-07 15:28:13 +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 Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-set-hook.c It is silly for cmd_list_parse to return an integer error when it could 2017-01-15 22:00:56 +00:00
cmd-set-option.c Style nits. 2017-02-16 10:53:25 +00:00
cmd-show-environment.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-show-messages.c Merge branch 'obsd-master' 2017-03-20 13:45:18 +00:00
cmd-show-options.c Merge branch 'obsd-master' 2017-01-31 00:01:12 +00:00
cmd-source-file.c Remove vis.h. 2017-02-15 08:37:11 +00:00
cmd-split-window.c Merge branch 'obsd-master' 2017-03-09 18:01:16 +00: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 Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-swap-window.c Instead of numbering session groups, give them a name which may be given 2017-02-09 15:04:53 +00:00
cmd-switch-client.c Cancel key table when switching session, unless the key is going to 2017-02-06 15:00:41 +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-01-24 22:01:13 +00:00
colour.c Instead of representing colours in several different forms with various 2016-07-15 00:42:56 +00:00
compat.h Compat code for strndup and strnlen. 2017-03-09 15:43:08 +00:00
configure.ac Should not need -D_POSIX_PTHREAD_SEMANTICS. 2017-03-22 07:49:27 +00:00
control-notify.c Add a helper function for the most common format_create/defaults/expand 2017-03-08 13:36:12 +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 Move server_fill_environ into environ.c and move some other common code 2017-03-09 17:02:38 +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 Merge branch 'obsd-master' 2017-03-08 14:01:23 +00: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 If moving cells outside the current used count, update it. 2017-03-07 13:47:56 +00: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-02-01 12:01:18 +00:00
input.c Add SGR 28 to clear hidden flag. 2017-02-19 07:55:11 +00:00
job.c Merge branch 'obsd-master' 2017-03-09 18:01:16 +00:00
key-bindings.c Cancel key table when switching session, unless the key is going to 2017-02-06 15:00:41 +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 Add a window or pane id "tag" to each format tree and use it to separate 2017-02-03 11:57:27 +00:00
notify.c Merge branch 'obsd-master' 2017-01-11 16:01:16 +00:00
options-table.c Merge branch 'obsd-master' 2017-01-24 22:01:13 +00:00
options.c Handle empty options correctly. 2017-03-08 14:43:40 +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
pty.c Hide or fix some warnings. 2017-02-15 08:54:21 +00:00
resize.c Improve some of the logging on resize. 2017-02-08 13:53:32 +00:00
screen-redraw.c Add a helper to store a cell, and some tidying. 2017-02-08 15:41:41 +00:00
screen-write.c Need to flush before writing out cells we are not collecting, also add 2017-03-07 13:48:28 +00: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-03-10 00:01:16 +00:00
server-fn.c Merge branch 'obsd-master' 2017-03-09 18:01:16 +00:00
server.c Merge branch 'obsd-master' 2017-02-14 13:55:16 +00:00
session.c Merge branch 'obsd-master' 2017-03-09 18:01:16 +00:00
signal.c Loads more static, except for cmd-*.c and window-*.c. 2016-10-10 21:29:23 +00:00
status.c Break the message storage function into its own function, useful for 2017-02-09 12:09:33 +00:00
style.c Major tidy up and rework of options tree and set-option/show-options 2017-01-15 20:48:41 +00:00
tmux.1 Merge branch 'obsd-master' 2017-02-15 10:01:17 +00:00
tmux.c Merge branch 'obsd-master' 2017-03-21 20:01:16 +00:00
tmux.h Merge branch 'obsd-master' 2017-03-09 18:01:16 +00: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 Don't use a bufferevent for the tty, so we can keep better track of what 2017-02-10 12:59:18 +00:00
tty-term.c Merge branch 'obsd-master' 2017-02-21 16:01:15 +00:00
tty.c Invalidate the cursor when we think we should have wrapped. 2017-03-15 15:22:14 +00:00
utf8.c Bad merge. 2017-03-21 14:48:44 +00:00
window-choose.c Add h and l for collapse and expand in choose mode with vi(1) keys, from 2017-03-17 14:41:54 +00:00
window-clock.c Add support for the OSC 4 and OSC 104 palette setting escape sequences, 2017-01-07 15:28:13 +00:00
window-copy.c Fix movement after select-line, from Omar Sandoval. 2017-03-21 09:51:00 +00:00
window.c Merge branch 'obsd-master' 2017-03-21 12:01:14 +00: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 Revert previous for now, it will break TERM=screen. 2017-01-25 14:36:08 +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>