Go to file
Thomas Adam 4123d69b51 README.md: github-specific readme
This is the same as the current README, but allows for markdown to be used.
We could switch this over to using the README file at some point.
2015-05-17 14:52:58 +01:00
compat queue.h should come from compat.h. 2015-05-07 11:43:52 +01:00
examples t_kP is the same as PageUp, so no need for it, from Daniel Hahler. 2014-12-21 15:46:43 +00:00
logo Add tmux logo, createed by Jason Long. 2015-04-28 13:46:47 +01:00
tools No need for $Id$ now. 2014-11-08 12:27:43 +00:00
www Add tmux4.png. 2015-04-28 16:04:07 +01:00
.gitignore Ignore .dirstamp files 2013-10-05 12:45:24 +01:00
.mailmap Sanitise additional .mailmap entries 2012-11-08 21:39:35 +00:00
.travis.yml TRAVIS-CI: correct path to configure 2015-05-17 14:39:04 +01:00
arguments.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
array.h Merge branch 'obsd-master' 2014-10-21 07:11:44 +01:00
attributes.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
autogen.sh Only set AUTO{MAKE,CONF}_VERSION on OpenBSD 2013-01-31 00:14:59 +00:00
cfg.c Merge branch 'obsd-master' 2015-05-09 12:52:38 +01:00
CHANGES CHANGES for tmux 2.0 2015-05-07 00:00:44 +01:00
client.c Merge branch 'obsd-master' 2015-04-25 10:02:46 +00:00
cmd-attach-session.c Move the functions to convert ids from strings into session.c and window.c. 2015-04-25 18:09:28 +00:00
cmd-bind-key.c Support for multiple key tables to commands to be bound to sequences of 2015-04-20 15:34:56 +00:00
cmd-break-pane.c Wrap all the individual format_* calls in a single format_defaults 2015-02-05 10:29:43 +00:00
cmd-capture-pane.c Move input parser structs into input.c (removing fairly useless 2015-05-08 16:18:04 +00:00
cmd-choose-buffer.c Rewrite of the target resolution internals to be simpler and more 2015-04-27 16:25:57 +00:00
cmd-choose-client.c Rewrite of the target resolution internals to be simpler and more 2015-04-27 16:25:57 +00:00
cmd-choose-tree.c Rewrite of the target resolution internals to be simpler and more 2015-04-27 16:25:57 +00:00
cmd-clear-history.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-command-prompt.c Rewrite of tmux mouse support which was a mess. Instead of having 2015-04-19 21:34:21 +00:00
cmd-confirm-before.c Rewrite of tmux mouse support which was a mess. Instead of having 2015-04-19 21:34:21 +00:00
cmd-copy-mode.c Bind mouse dragging so that it is passed through to applications if they 2015-04-21 15:34:32 +00:00
cmd-delete-buffer.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-detach-client.c Convert clients list into a TAILQ. 2015-04-24 23:17:11 +00:00
cmd-display-message.c Rewrite of the target resolution internals to be simpler and more 2015-04-27 16:25:57 +00:00
cmd-display-panes.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-find-window.c Use a TAILQ not array for find-window. 2015-05-07 07:59:52 +00:00
cmd-find.c Merge branch 'obsd-master' 2015-05-09 12:52:38 +01:00
cmd-if-shell.c Set working directory for run-shell and if-shell. 2015-04-24 22:19:36 +00:00
cmd-join-pane.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-kill-pane.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-kill-server.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-kill-session.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-kill-window.c Add a format window_linked which is 1 if a window has been linked 2015-05-06 08:35:39 +00:00
cmd-list-buffers.c Wrap all the individual format_* calls in a single format_defaults 2015-02-05 10:29:43 +00:00
cmd-list-clients.c Convert clients list into a TAILQ. 2015-04-24 23:17:11 +00:00
cmd-list-keys.c Support for multiple key tables to commands to be bound to sequences of 2015-04-20 15:34:56 +00:00
cmd-list-panes.c Wrap all the individual format_* calls in a single format_defaults 2015-02-05 10:29:43 +00:00
cmd-list-sessions.c Wrap all the individual format_* calls in a single format_defaults 2015-02-05 10:29:43 +00:00
cmd-list-windows.c Wrap all the individual format_* calls in a single format_defaults 2015-02-05 10:29:43 +00:00
cmd-list.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-load-buffer.c Rewrite of the target resolution internals to be simpler and more 2015-04-27 16:25:57 +00:00
cmd-lock-server.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-move-window.c Fix moving windows to nonexistent indexes when renumber-windows is 2015-04-21 21:24:49 +00:00
cmd-new-session.c Rewrite of the target resolution internals to be simpler and more 2015-04-27 16:25:57 +00:00
cmd-new-window.c Remove a couple of now-unused variables. 2015-02-05 10:32:39 +00:00
cmd-paste-buffer.c Merge branch 'obsd-master' 2014-11-09 00:15:51 +00:00
cmd-pipe-pane.c No paths.h on Solaris. 2015-02-06 23:24:44 +00:00
cmd-queue.c Rewrite of tmux mouse support which was a mess. Instead of having 2015-04-19 21:34:21 +00:00
cmd-refresh-client.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-rename-session.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-rename-window.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-resize-pane.c Rewrite of tmux mouse support which was a mess. Instead of having 2015-04-19 21:34:21 +00:00
cmd-respawn-pane.c Fix some format specifier nits, from Ben Boeckel. 2015-03-31 17:45:10 +00:00
cmd-respawn-window.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-rotate-window.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-run-shell.c Set working directory for run-shell and if-shell. 2015-04-24 22:19:36 +00:00
cmd-save-buffer.c Merge branch 'obsd-master' 2015-04-27 21:21:55 +01:00
cmd-select-layout.c Add select-layout -o to undo the last layout change (apply the previously 2015-04-28 10:43:13 +00:00
cmd-select-pane.c Do not complain when directions fail. 2015-04-29 16:26:17 +00:00
cmd-select-window.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-send-keys.c Move input parser structs into input.c (removing fairly useless 2015-05-08 16:18:04 +00:00
cmd-set-buffer.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-set-environment.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-set-option.c Convert clients list into a TAILQ. 2015-04-24 23:17:11 +00:00
cmd-show-environment.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-show-messages.c Merge branch 'obsd-master' 2015-05-13 09:44:11 +01:00
cmd-show-options.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-source-file.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-split-window.c Merge branch 'obsd-master' 2015-04-27 21:21:55 +01:00
cmd-string.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-swap-pane.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-swap-window.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-switch-client.c Update environment when switching sessions as well as attaching, from Si 2015-05-07 14:07:16 +00:00
cmd-unbind-key.c Support for multiple key tables to commands to be bound to sequences of 2015-04-20 15:34:56 +00:00
cmd-wait-for.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd.c Merge branch 'obsd-master' 2015-04-27 21:21:55 +01:00
colour.c Fix some format specifier nits, from Ben Boeckel. 2015-03-31 17:45:10 +00:00
compat.h OS X lacks HOST_NAME_MAX, reported by Christian Ebert. 2014-10-21 11:00:16 +01:00
configure.ac Start working on 2.1 2015-05-07 00:00:44 +01:00
control-notify.c Convert clients list into a TAILQ. 2015-04-24 23:17:11 +00:00
control.c Rewrite of tmux mouse support which was a mess. Instead of having 2015-04-19 21:34:21 +00:00
COPYING Add a COPYING file, suggested by Dagobert Michelsen. 2013-05-31 12:59:17 +01:00
environ.c Simplify environ_push so it doesn't need the ARRAY_* functions. 2015-05-07 07:35:31 +00:00
FAQ Use -a for terminal-overrides from Daniel Hahler. 2014-11-06 10:30:05 +00:00
format.c Merge branch 'obsd-master' 2015-05-13 09:44:11 +01:00
grid-cell.c Rather than having two grids for each pane, one for ASCII and one for 2013-01-18 02:16:21 +00:00
grid-view.c Revert to r1.16 since this is still clearly broken and I can't see how 2015-01-06 21:14:42 +00:00
grid.c Remove some stuff that accidentally ended up here from portable, and 2015-05-08 15:56:49 +00:00
input-keys.c Merge branch 'obsd-master' 2015-04-22 10:05:54 +01:00
input.c Remove the c0-* options which never really worked satisfactorily. Going 2015-05-11 10:10:16 +00:00
job.c Merge branch 'obsd-master' 2015-04-25 10:02:46 +00:00
key-bindings.c Style spacing nits. 2015-05-07 11:42:56 +00:00
key-string.c Rewrite of tmux mouse support which was a mess. Instead of having 2015-04-19 21:34:21 +00:00
layout-custom.c Always format real layout even when zoomed. 2015-04-21 22:38:49 +00:00
layout-set.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
layout.c Rewrite of tmux mouse support which was a mess. Instead of having 2015-04-19 21:34:21 +00:00
log.c Merge branch 'obsd-master' 2014-12-03 08:41:08 +00:00
Makefile.am Add tmux4.png. 2015-04-28 16:04:07 +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
mode-key.c mode_key_entry can go into mode-key.c; also a few spaces->tabs. 2015-05-08 16:33:29 +00:00
names.c Wrap all the individual format_* calls in a single format_defaults 2015-02-05 10:29:43 +00:00
notify.c Merge branch 'obsd-master' 2015-04-25 10:02:46 +00:00
options-table.c Merge branch 'obsd-master' 2015-05-13 09:44:11 +01:00
options.c When given an invalid style, don't set the option to the default. Fix 2015-02-18 15:32:37 +00:00
osdep-aix.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
osdep-cygwin.c Need param.h, from Ismail Donmez. 2014-12-31 10:00:47 +00:00
osdep-darwin.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
osdep-dragonfly.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
osdep-freebsd.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
osdep-hpux.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
osdep-linux.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
osdep-netbsd.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
osdep-openbsd.c Merge branch 'obsd-master' 2015-01-16 19:17:31 +00:00
osdep-sunos.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
osdep-unknown.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
paste.c Merge branch 'obsd-master' 2015-04-19 14:44:56 +01:00
README Note libevent version. 2013-12-09 22:53:17 +00:00
README.md README.md: github-specific readme 2015-05-17 14:52:58 +01:00
resize.c Convert clients list into a TAILQ. 2015-04-24 23:17:11 +00:00
screen-redraw.c If status line is at the top, the offset needs to be adjusted when 2015-05-07 07:16:14 +00:00
screen-write.c Two improvements to reflow from Balazs Kezes: 2014-11-08 12:58:31 +00:00
screen.c Merge branch 'obsd-master' 2015-01-16 19:17:31 +00:00
server-client.c Add back __CYGWIN__ block 2015-05-09 20:03:24 +01:00
server-fn.c Merge branch 'obsd-master' 2015-04-29 18:42:12 +01:00
server-window.c Add bell-action "other" to pass through bells in all windows except the 2015-05-12 15:27:46 +00:00
server.c Merge branch 'obsd-master' 2015-04-25 10:02:46 +00:00
session.c Merge branch 'obsd-master' 2015-05-06 10:03:52 +01:00
signal.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
status.c Remove ARRAY_* from history and expand completion to complete a) layout 2015-05-06 23:56:46 +00:00
style.c Style spacing nits. 2015-05-07 11:42:56 +00:00
SYNCING SYNCING: Make a note about libutils 2014-08-09 20:32:09 +01:00
tmux.1 Merge branch 'obsd-master' 2015-05-13 09:44:11 +01:00
tmux.c Merge branch 'obsd-master' 2015-02-06 19:07:43 +00:00
tmux.h Merge branch 'obsd-master' 2015-05-13 09:44:11 +01:00
TODO +. 2015-04-20 08:46:21 +01:00
tty-acs.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
tty-keys.c Rewrite of tmux mouse support which was a mess. Instead of having 2015-04-19 21:34:21 +00:00
tty-term.c Merge branch 'obsd-master' 2015-04-20 15:44:27 +01:00
tty.c To replace c0-*, add a high watermark to the pty event, and also backoff 2015-05-12 22:40:38 +00:00
utf8.c Merge branch 'obsd-master' 2015-04-22 10:05:54 +01:00
window-choose.c window_choose_mode_item can move into window-choose.c. 2015-05-08 16:23:34 +00:00
window-clock.c Rewrite of tmux mouse support which was a mess. Instead of having 2015-04-19 21:34:21 +00:00
window-copy.c Set working directory for run-shell and if-shell. 2015-04-24 22:19:36 +00:00
window.c Merge branch 'obsd-master' 2015-05-13 09:44:11 +01:00
xmalloc.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
xterm-keys.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00

Welcome to tmux!

Build Status

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 FreeBSD, NetBSD, Linux and OS X and may still run on Solaris and AIX.

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

http://www.monkey.org/~provos/libevent/

To build tmux from a release tarball, do:

$ ./configure && make
$ sudo make install

To get and build the latest from version control:

$ git clone git://git.code.sf.net/p/tmux/tmux-code tmux
$ cd tmux
$ sh autogen.sh
$ ./configure && make

For more information see https://sourceforge.net/scm/?type=git&group_id=200378 and http://git-scm.com. Patches should be sent by email to the mailing list at tmux-users@lists.sourceforge.net.

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 and a more extensive (but slightly out of date) guide is available in the OpenBSD FAQ at http://www.openbsd.org/faq/faq7.html#tmux. A rough todo list is in the TODO file and some example configurations and a Vim syntax file are in the examples directory.

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

tmux mailing lists are available. Visit:

https://sourceforge.net/mail/?group_id=200378

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

tmux-users@lists.sourceforge.net

This file and the CHANGES, FAQ, TODO, and SYNCING files are licensed under the ISC license. Files under examples/ remain copyright their authors unless otherwise stated in the file but permission has been received to distribute them with tmux. All other files have a license and copyright notice at their start.