Menu

Tree [f8481f] master /
 History

HTTPS access


File Date Author Commit
 compat unknown
 examples unknown
 tools unknown
 www unknown
 .gitignore unknown
 .mailmap unknown
 CHANGES unknown
 COPYING unknown
 FAQ unknown
 Makefile.am 2014-06-18 Nicholas Marriott Nicholas Marriott [f5973b] Build DEBUG with -O2 as well.
 README unknown
 SYNCING unknown
 TODO 2014-06-21 Nicholas Marriott Nicholas Marriott [cddf50] Notes for better mouse support.
 arguments.c 2014-04-11 nicm nicm [b8bda6] Don't blindly increase offsets by the return va...
 array.h 2012-07-10 Nicholas Marriott Nicholas Marriott [df912e] xfree is not particularly helpful, remove it. F...
 attributes.c 2012-03-17 Nicholas Marriott Nicholas Marriott [50f5d2] Use snprintf for constructing attribute string,...
 autogen.sh unknown
 cfg.c 2014-04-17 nicm nicm [bce952] Remove some unnecessary includes and fix a typo.
 client.c 2014-04-29 nicm nicm [5b2c81] fcntl.h is still needed here.
 cmd-attach-session.c 2014-02-23 nicm nicm [f18289] Change terminal-overrides to a server option (n...
 cmd-bind-key.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-break-pane.c 2014-04-17 nicm nicm [2e98c9] Correct the dance to fix the active pane in joi...
 cmd-capture-pane.c 2014-04-24 nicm nicm [bec6c8] There is no longer a need for a paste_stack str...
 cmd-choose-buffer.c 2014-04-24 nicm nicm [bec6c8] There is no longer a need for a paste_stack str...
 cmd-choose-client.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-choose-tree.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-clear-history.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-clock-mode.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-command-prompt.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-confirm-before.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-copy-mode.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-delete-buffer.c 2014-04-24 nicm nicm [bec6c8] There is no longer a need for a paste_stack str...
 cmd-detach-client.c 2013-10-15 nicm nicm [2eb6d6] Fix detach -a by skipping clients where the ses...
 cmd-display-message.c 2013-10-10 nicm nicm [1b7c2d] Trivial style and spacing nits.
 cmd-display-panes.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-find-window.c 2014-04-17 nicm nicm [a5d4b7] Some more long lines.
 cmd-has-session.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-if-shell.c 2013-10-10 nicm nicm [fc54bf] Make cmdq->client_exit a tristate (-1 means "no...
 cmd-join-pane.c 2014-04-17 nicm nicm [2e98c9] Correct the dance to fix the active pane in joi...
 cmd-kill-pane.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-kill-server.c 2014-01-27 nicm nicm [dda70d] Merge start-server into kill-server.
 cmd-kill-session.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-kill-window.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-link-window.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-list-buffers.c 2014-04-24 nicm nicm [bec6c8] There is no longer a need for a paste_stack str...
 cmd-list-clients.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-list-commands.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-list-keys.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-list-panes.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-list-sessions.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-list-windows.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-list.c 2014-04-11 nicm nicm [b8bda6] Don't blindly increase offsets by the return va...
 cmd-load-buffer.c 2014-04-24 nicm nicm [bec6c8] There is no longer a need for a paste_stack str...
 cmd-lock-server.c 2014-04-17 nicm nicm [bce952] Remove some unnecessary includes and fix a typo.
 cmd-move-window.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-new-session.c 2014-04-17 nicm nicm [3e27be] Set PATH explicitly, either from client or session
 cmd-new-window.c 2014-04-17 nicm nicm [3e27be] Set PATH explicitly, either from client or session
 cmd-paste-buffer.c 2014-04-24 nicm nicm [bec6c8] There is no longer a need for a paste_stack str...
 cmd-pipe-pane.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-queue.c 2014-04-17 nicm nicm [274049] Remove the "info" message mechanism, this was o...
 cmd-refresh-client.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-rename-session.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-rename-window.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-resize-pane.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-respawn-pane.c 2014-04-17 nicm nicm [3e27be] Set PATH explicitly, either from client or session
 cmd-respawn-window.c 2014-04-17 nicm nicm [3e27be] Set PATH explicitly, either from client or session
 cmd-rotate-window.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-run-shell.c 2014-04-17 nicm nicm [274049] Remove the "info" message mechanism, this was o...
 cmd-save-buffer.c 2014-04-24 nicm nicm [bec6c8] There is no longer a need for a paste_stack str...
 cmd-select-layout.c 2014-04-17 nicm nicm [274049] Remove the "info" message mechanism, this was o...
 cmd-select-pane.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-select-window.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-send-keys.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-set-buffer.c 2014-04-24 nicm nicm [bec6c8] There is no longer a need for a paste_stack str...
 cmd-set-environment.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-set-option.c 2014-04-17 nicm nicm [a5d4b7] Some more long lines.
 cmd-show-environment.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-show-messages.c 2014-02-14 nicm nicm [f835be] Style nit - no space between function name and ...
 cmd-show-options.c 2014-04-17 nicm nicm [ebc5cb] Do not show the -fg, -bg and -attr options. If ...
 cmd-source-file.c 2013-10-10 nicm nicm [fc54bf] Make cmdq->client_exit a tristate (-1 means "no...
 cmd-split-window.c 2014-04-17 nicm nicm [3e27be] Set PATH explicitly, either from client or session
 cmd-string.c 2013-10-10 nicm nicm [165aa5] Make tilde expansion in command strings work ev...
 cmd-suspend-client.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-swap-pane.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-swap-window.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-switch-client.c 2014-04-17 nicm nicm [274049] Remove the "info" message mechanism, this was o...
 cmd-unbind-key.c 2013-10-11 nicm nicm [ffba21] Remove stray return, from Chris Johnsen.
 cmd-unlink-window.c 2013-10-10 nicm nicm [d45c12] Remove the barely-used and unnecessary command ...
 cmd-wait-for.c 2013-10-10 nicm nicm [1bd085] Mark flags as optional and mutually exclusive. ...
 cmd.c 2014-04-16 nicm nicm [14a96d] Remove the choose-list command to prepare for s...
 colour.c 2013-03-27 Nicholas Marriott Nicholas Marriott [982354] Remove tmux's (already minimal) 88 colour suppo...
 compat.h unknown
 configure.ac unknown
 control-notify.c 2014-04-23 nicm nicm [7ab269] Differentiate between linked and unlinked windo...
 control.c 2013-10-10 nicm nicm [4c9f41] Pass flags into cmdq_guard as an argument since...
 environ.c 2014-04-17 nicm nicm [a5d4b7] Some more long lines.
 format.c 2014-04-17 nicm nicm [806520] Add some UTF-8 utility functions and use them t...
 grid-cell.c 2013-01-18 Nicholas Marriott Nicholas Marriott [fdbfc7] Rather than having two grids for each pane, one...
 grid-view.c 2014-04-17 nicm nicm [a5d4b7] Some more long lines.
 grid.c 2014-04-16 nicm nicm [5acee1] Memory leak in error path and unnecessary assig...
 input-keys.c 2014-04-24 nicm nicm [bec6c8] There is no longer a need for a paste_stack str...
 input.c 2014-04-17 nicm nicm [ada75a] Don't limit the DCS buffer to 256 bytes, expand...
 job.c 2014-04-14 nicm nicm [a47d23] Don't leak socketpair file descriptors if fork ...
 key-bindings.c 2014-04-17 nicm nicm [274049] Remove the "info" message mechanism, this was o...
 key-string.c 2013-03-22 Nicholas Marriott Nicholas Marriott [306a3b] In terminals with XT, turn on modifyOtherKeys=1...
 layout-custom.c 2013-03-25 Nicholas Marriott Nicholas Marriott [e0961d] Fix handling of short (< 4 character) checksums...
 layout-set.c 2014-04-17 nicm nicm [a5d4b7] Some more long lines.
 layout.c 2014-02-22 nicm nicm [315d45] Fix crash due to uninitialized lastwp member of...
 log.c 2014-03-31 nicm nicm [48478e] Remove log_debug2 as well and simplify log.c.
 mdoc2man.awk unknown
 mode-key.c 2014-03-31 nicm nicm [0e4d1d] Add setb -a to append and a copy mode append co...
 names.c 2013-10-10 nicm nicm [fd1750] Add automatic-rename-format option allowing aut...
 notify.c 2012-09-25 Nicholas Marriott Nicholas Marriott [17bbf9] Add notification for input from a pane, from Ge...
 options-table.c 2014-04-17 nicm nicm [c3b2e5] Wrap some long lines.
 options.c 2014-01-28 nicm nicm [945339] Allow replacing each of the many sets of separa...
 osdep-aix.c unknown
 osdep-cygwin.c unknown
 osdep-darwin.c unknown
 osdep-dragonfly.c unknown
 osdep-freebsd.c unknown
 osdep-hpux.c unknown
 osdep-linux.c unknown
 osdep-netbsd.c unknown
 osdep-openbsd.c unknown
 osdep-sunos.c unknown
 osdep-unknown.c unknown
 paste.c 2014-04-24 nicm nicm [bec6c8] There is no longer a need for a paste_stack str...
 resize.c 2014-03-31 nicm nicm [b11de5] Make session_attached a count and add session_m...
 screen-redraw.c 2014-03-31 nicm nicm [175f21] Having three *clock* files is ridiculous, remov...
 screen-write.c 2014-04-17 nicm nicm [a5d4b7] Some more long lines.
 screen.c 2014-01-09 nicm nicm [adc1f2] Three small changes from Tiago Cunha:
 server-client.c 2014-04-16 nicm nicm [e5d85c] Because we pass the file descriptor from client...
 server-fn.c 2014-04-17 nicm nicm [a5d4b7] Some more long lines.
 server-window.c 2014-04-17 nicm nicm [992ef7] Remove the monitor-content option and associate...
 server.c 2014-04-24 nicm nicm [bec6c8] There is no longer a need for a paste_stack str...
 session.c 2014-04-17 nicm nicm [3e27be] Set PATH explicitly, either from client or session
 signal.c 2010-08-19 Nicholas Marriott Nicholas Marriott [e3be9b] Do not call event_del() for signals after fork(...
 status.c 2014-04-24 nicm nicm [bec6c8] There is no longer a need for a paste_stack str...
 style.c 2014-02-22 nicm nicm [c7f359] Fix -fg/-bg/-style with 256 colour terminals.
 tmux.1 2014-04-17 nicm nicm [64613b] #nnT went away a while ago, remove a leftover f...
 tmux.c 2014-04-17 nicm nicm [274049] Remove the "info" message mechanism, this was o...
 tmux.h 2014-04-24 nicm nicm [bec6c8] There is no longer a need for a paste_stack str...
 tty-acs.c 2013-11-24 nicm nicm [d45931] Add comments to ACS table matching terminfo(5).
 tty-keys.c 2014-04-03 nicm nicm [acef31] Work out mouse scroll wheel effect when the mou...
 tty-term.c 2014-04-17 nicm nicm [c3b2e5] Wrap some long lines.
 tty.c 2014-04-25 jsg jsg [40cb4c] specifying ECHOCTL once is enough
 utf8.c 2014-04-17 nicm nicm [806520] Add some UTF-8 utility functions and use them t...
 window-choose.c 2014-04-17 nicm nicm [f194f1] Only scroll by one line at a time in choose mod...
 window-clock.c 2014-03-31 nicm nicm [175f21] Having three *clock* files is ridiculous, remov...
 window-copy.c 2014-04-24 nicm nicm [bec6c8] There is no longer a need for a paste_stack str...
 window.c 2014-04-17 nicm nicm [a5d4b7] Some more long lines.
 xmalloc.c 2012-07-10 Nicholas Marriott Nicholas Marriott [df912e] xfree is not particularly helpful, remove it. F...
 xterm-keys.c 2014-02-10 nicm nicm [c52548] The last fix to xterm keys meant that some keys...

Read Me

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 and OS X and may still
run on Solaris and AIX (although they haven't been tested in a while).

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 and TODO 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.

-- Nicholas Marriott <nicm@users.sf.net>

$Id$