Go to file
Nicholas Marriott 7e4908f751 If --enable-{utf8proc,utempter} is given, do not build without it. 2017-01-18 14:32:50 +00:00
compat Do not force symbols to width 1, from Yen Chi Hsuan. 2016-10-28 19:58:14 +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
tools One extra empty line not in OpenBSD, and tweak a #define style. 2016-10-17 19:25:45 +01: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 Note about TERM. 2016-11-04 13:18:09 +00:00
COPYING Add a COPYING file, suggested by Dagobert Michelsen. 2013-05-31 12:59:17 +01:00
FAQ Note version this happened. 2015-06-04 08:47:23 +01:00
Makefile.am Put AM_* back, but this time do a dance in configure.ac so that we can keep 2016-10-19 15:20:21 +01:00
README utempter is no longer the default, and mention ncurses. 2016-12-20 16:28:11 +00:00
SYNCING Rename found_debug to enable_debug. 2016-10-18 20:19:24 +01:00
TODO Change around the example .tmux.conf to show some newer features. 2017-01-10 19:26:54 +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 No need for $Id$ now. 2014-11-08 12:27:43 +00:00
autogen.sh Remove $Id$. 2015-06-03 18:26:25 +01:00
cfg.c Merge branch 'obsd-master' 2017-01-16 00:01:10 +00:00
client.c Revert WIP parts of previous I didn't mean to commit yet. 2017-01-16 14:52:25 +00:00
cmd-attach-session.c Use the notify name string instead of going via an enum and change 2016-10-16 22:06:40 +00:00
cmd-bind-key.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-break-pane.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-capture-pane.c Escape backspace for capture-pane -P, from George Nachman. 2017-01-02 22:42:19 +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-clear-history.c Minor tidying in a couple of commands. 2017-01-10 19:45:55 +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 Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-display-panes.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-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' 2016-11-16 02:01:11 +00:00
cmd-if-shell.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-join-pane.c Merge branch 'obsd-master' 2016-10-17 00:01:11 +01:00
cmd-kill-pane.c killp -a should not kill the window if only one pane. 2017-01-14 18:53:08 +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 Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-list-clients.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-list-keys.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-list-panes.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-list-sessions.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-list-windows.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +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 Nits found with clang. 2017-01-06 13:26:09 +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 Make options_get_string return const string. 2017-01-13 11:56:43 +00:00
cmd-new-window.c Use the notify name string instead of going via an enum and change 2016-10-16 22:06:40 +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' 2016-10-16 22:01:14 +01:00
cmd-queue.c Highlight all occurrences of search string after searching in copy mode. 2017-01-05 09:07:15 +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 Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-respawn-window.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +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 Apply the right fix for run -b, used the wrong diff before. 2016-11-12 19:05:53 +00:00
cmd-save-buffer.c Merge branch 'obsd-master' 2017-01-06 14:01:15 +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 getopt() has a struct option so just return to using options_entry. 2017-01-16 14:49:14 +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' 2016-10-16 22:01:14 +01:00
cmd-show-options.c Merge branch 'obsd-master' 2017-01-18 12:01:11 +00:00
cmd-source-file.c source-file -q needs to apply to glob(3) too. 2017-01-09 19:29:12 +00:00
cmd-split-window.c Merge branch 'obsd-master' 2016-10-17 00:01:11 +01:00
cmd-string.c Revert WIP parts of previous I didn't mean to commit yet. 2017-01-16 14:52:25 +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 Fix up winlink lists after swap-window. 2016-12-14 17:38:59 +00:00
cmd-switch-client.c Nits found with clang. 2017-01-06 13:26:09 +00:00
cmd-unbind-key.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +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 Revert WIP parts of previous I didn't mean to commit yet. 2017-01-16 14:52:25 +00:00
colour.c Instead of representing colours in several different forms with various 2016-07-15 00:42:56 +00:00
compat.h tmux no longer uses openat() so we can remove the compatibilty function. 2016-10-13 22:17:29 +01:00
configure.ac If --enable-{utf8proc,utempter} is given, do not build without it. 2017-01-18 14:32:50 +00:00
control-notify.c Use the notify name string instead of going via an enum and change 2016-10-16 22:06:40 +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 Loads more static, except for cmd-*.c and window-*.c. 2016-10-10 21:29:23 +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-01-16 15:36:02 +00:00
grid-view.c Add support for BCE (background colour erase). This makes various escape 2016-10-13 20:27:27 +00:00
grid.c Clear cell entry with grid_default_entry not grid_default_cell. 2016-10-18 19:52:49 +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' 2016-10-04 02:01:11 +01:00
input.c Add support for the OSC 4 and OSC 104 palette setting escape sequences, 2017-01-07 15:28:13 +00:00
job.c Merge branch 'obsd-master' 2016-10-12 09:45:49 +01:00
key-bindings.c Revert WIP parts of previous I didn't mean to commit yet. 2017-01-16 14:52:25 +00:00
key-string.c Add some missing special keys to key_string_lookup_key, fix a mouse 2017-01-11 22:36:07 +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 Use the notify name string instead of going via an enum and change 2016-10-16 22:06:40 +00:00
log.c Merge branch 'obsd-master' 2016-01-19 18:01:15 +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
mode-key.c Drop the edit mode key tables and just use fixed key bindings for the 2016-10-12 14:50:14 +00:00
names.c Make options_get_string return const string. 2017-01-13 11:56:43 +00:00
notify.c Merge branch 'obsd-master' 2017-01-11 16:01:16 +00:00
options-table.c Revert WIP parts of previous I didn't mean to commit yet. 2017-01-16 14:52:25 +00:00
options.c Do not reset idx, it has just been set. 2017-01-18 08:43:21 +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 Update my email address. 2016-01-19 18:07:25 +00:00
osdep-openbsd.c Merge branch 'obsd-master' 2016-10-12 09:45:49 +01:00
osdep-sunos.c Solaris build fixes from Rob Paisley. 2016-09-08 15:32:15 +01:00
osdep-unknown.c Update my email address. 2016-01-19 18:07:25 +00:00
paste.c Merge branch 'obsd-master' 2016-10-13 08:09:47 +01:00
proc.c One extra empty line not in OpenBSD, and tweak a #define style. 2016-10-17 19:25:45 +01:00
resize.c Use the notify name string instead of going via an enum and change 2016-10-16 22:06:40 +00:00
screen-redraw.c Add support for the OSC 4 and OSC 104 palette setting escape sequences, 2017-01-07 15:28:13 +00:00
screen-write.c Fix setting the palette of aixterm colours (90-97). 2017-01-12 00:19:32 +00:00
screen.c Make the selection able to exist independent of the cursor position, so 2016-11-24 13:38:44 +00:00
server-client.c Merge branch 'obsd-master' 2017-01-13 14:01:13 +00:00
server-fn.c Merge branch 'obsd-master' 2017-01-13 14:01:13 +00:00
server.c Merge branch 'obsd-master' 2016-11-12 20:01:10 +00:00
session.c Merge branch 'obsd-master' 2016-10-19 12:01:11 +01:00
signal.c Loads more static, except for cmd-*.c and window-*.c. 2016-10-10 21:29:23 +00:00
status.c Make options_get_string return const string. 2017-01-13 11:56:43 +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-01-13 12:01:12 +00:00
tmux.c Merge branch 'obsd-master' 2017-01-15 22:01:11 +00:00
tmux.h Merge branch 'obsd-master' 2017-01-18 12:01:11 +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 Use a macro for looking up tty types. 2017-01-11 16:05:46 +00:00
tty-term.c Merge branch 'obsd-master' 2017-01-13 14:01:13 +00:00
tty.c aixterm colours can be used if -2 is given, as well as if TERM tells us 2017-01-12 00:30:41 +00:00
utf8.c Merge branch 'obsd-master' 2017-01-18 12:01:11 +00:00
window-choose.c It is silly for cmd_list_parse to return an integer error when it could 2017-01-15 22:00:56 +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 Add support for the OSC 4 and OSC 104 palette setting escape sequences, 2017-01-07 15:28:13 +00:00
window.c Merge branch 'obsd-master' 2017-01-12 12:01:10 +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 Remove some dead code in cmd-move-window.c and make a load of local 2016-10-03 22:52:11 +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 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/keith/tmux.vim
	https://raw.githubusercontent.com/keith/tmux.vim/master/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>