Instant Terminal Sharing
Go to file
2013-10-10 10:27:23 +01:00
compat Add openat() to compat. 2013-10-10 10:27:23 +01:00
examples Add wait-for to tmux.vim from Ben Boeckel. 2013-04-10 13:04:19 +01:00
tools Expand the Id keyword. 2011-07-09 09:42:33 +00:00
www www Project Page -> SourceForge Page 2013-02-23 14:51:56 +00: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
arguments.c Merge branch 'obsd-master' 2013-05-31 21:44:42 +01:00
array.h Sync OpenBSD patchset 1150: 2012-07-11 19:34:16 +00:00
attributes.c Sync OpenBSD patchset 1067: 2012-03-18 02:17:20 +00:00
autogen.sh Only set AUTO{MAKE,CONF}_VERSION on OpenBSD 2013-01-31 00:14:59 +00:00
cfg.c Add some additional debug logging. 2013-03-25 10:06:13 +00:00
CHANGES Trivial typo fixes in changes. 2013-03-27 23:37:05 +00:00
client.c We accidentally haven't been using $TMUX to work out the session for a while 2013-10-06 22:38:33 +01:00
clock.c Merge branch 'obsd-master' 2013-04-13 17:05:49 +01:00
cmd-attach-session.c Show session name in detached message. Requested by somebody a few months ago 2013-10-06 21:21:52 +01:00
cmd-bind-key.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-break-pane.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-capture-pane.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-choose-buffer.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-choose-client.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-choose-list.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-choose-tree.c Merge branch 'master' of ssh://git.code.sf.net/p/tmux/tmux-code 2013-08-21 18:03:07 +01:00
cmd-clear-history.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-clock-mode.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-command-prompt.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-confirm-before.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-copy-mode.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-delete-buffer.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-detach-client.c Show session name in detached message. Requested by somebody a few months ago 2013-10-06 21:21:52 +01:00
cmd-display-message.c Trivial style and spacing nits. 2013-08-21 18:35:01 +01:00
cmd-display-panes.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-find-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-has-session.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-if-shell.c Make cmdq->client_exit a tristate (-1 means "not set") so that if explicitly 2013-10-01 23:31:09 +01:00
cmd-join-pane.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-kill-pane.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-kill-server.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-kill-session.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-kill-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-link-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-list-buffers.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-list-clients.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-list-commands.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-list-keys.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-list-panes.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-list-sessions.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-list-windows.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-list.c Add a command queue to standardize and simplify commands that call other 2013-02-23 22:25:58 +00:00
cmd-load-buffer.c Alter how tmux handles the working directory to internally use file descriptors 2013-10-06 21:02:23 +01:00
cmd-lock-server.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-move-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-new-session.c Don't boke when figuring out working directory from configuration file. 2013-10-06 21:31:55 +01:00
cmd-new-window.c Don't boke when figuring out working directory from configuration file. 2013-10-06 21:31:55 +01:00
cmd-paste-buffer.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-pipe-pane.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-queue.c Alter how tmux handles the working directory to internally use file descriptors 2013-10-06 21:02:23 +01:00
cmd-refresh-client.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-rename-session.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-rename-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-resize-pane.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-respawn-pane.c Pass -1 for cwd now not NULL. 2013-10-06 22:44:24 +01:00
cmd-respawn-window.c Pass -1 for cwd now not NULL. 2013-10-06 22:44:24 +01:00
cmd-rotate-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-run-shell.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-save-buffer.c Alter how tmux handles the working directory to internally use file descriptors 2013-10-06 21:02:23 +01:00
cmd-select-layout.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-select-pane.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-select-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-send-keys.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-server-info.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-set-buffer.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-set-environment.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-set-option.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-show-environment.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-show-messages.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-show-options.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-source-file.c Make cmdq->client_exit a tristate (-1 means "not set") so that if explicitly 2013-10-01 23:31:09 +01:00
cmd-split-window.c Don't boke when figuring out working directory from configuration file. 2013-10-06 21:31:55 +01:00
cmd-start-server.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-string.c Make tilde expansion in command strings work even if it isn't terminated by /. 2013-10-06 09:06:07 +01:00
cmd-suspend-client.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-swap-pane.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-swap-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-switch-client.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-unbind-key.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-unlink-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-wait-for.c Mark flags as optional and mutually exclusive. 2013-08-31 11:16:47 +01:00
cmd.c We accidentally haven't been using $TMUX to work out the session for a while 2013-10-06 22:38:33 +01:00
colour.c Merge branch 'obsd-master' 2013-04-13 17:05:49 +01:00
compat.h Add openat() to compat. 2013-10-10 10:27:23 +01:00
configure.ac Add openat() to compat. 2013-10-10 10:27:23 +01:00
control-notify.c Fix compiler warnings, missing #include. From Thomas Adam. 2013-03-26 10:54:48 +00:00
control.c Pass flags into cmdq_guard as an argument since sometimes cmdq->cmd can be 2013-08-01 23:35:03 +01:00
COPYING Add a COPYING file, suggested by Dagobert Michelsen. 2013-05-31 12:59:17 +01:00
environ.c Sync OpenBSD patchset 1150: 2012-07-11 19:34:16 +00:00
FAQ Add entry about smaller clients based on text from Thomas Adam. 2013-08-31 10:42:09 +01:00
format.c Alter how tmux handles the working directory to internally use file descriptors 2013-10-06 21:02:23 +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 Preserve trailing spaces with capture-pane -J, from George Nachman. 2013-03-25 10:05:35 +00:00
grid.c Trivial style and spacing nits. 2013-08-21 18:35:01 +01:00
input-keys.c Merge branch 'obsd-master' 2013-05-25 11:48:12 +01:00
input.c Accept multiple parameters to SM/RM/DECSET/DECRST, based on a diff from Hayaki 2013-08-19 22:31:38 +01:00
job.c Add openat() to compat. 2013-10-10 10:27:23 +01:00
key-bindings.c Add resize-pane -Z to temporary zoom the active pane to occupy the full 2013-03-24 09:57:59 +00:00
key-string.c In terminals with XT, turn on modifyOtherKeys=1 with the escape sequence and 2013-02-17 22:56:12 +00:00
layout-custom.c Fix handling of short (< 4 character) checksums and a bug with parsing 2013-03-25 11:35:30 +00:00
layout-set.c Sync OpenBSD patchset 978: 2011-11-10 21:41:37 +00:00
layout.c mouse-resize-pane: Only resize on border select 2013-10-02 06:53:47 +01:00
log.c Do not use stderr for log file and don't call log_close when not needed. 2012-05-30 15:01:57 +00:00
Makefile.am Add openat() to compat. 2013-10-10 10:27:23 +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 Merge branch 'obsd-master' 2013-07-06 11:18:49 +01:00
names.c Add automatic-rename-format option allowing automatic rename to use something 2013-08-19 22:16:11 +01:00
notify.c Merge branch 'obsd-master' 2012-09-25 17:05:36 +01:00
options-table.c Alter how tmux handles the working directory to internally use file descriptors 2013-10-06 21:02:23 +01:00
options.c Sync OpenBSD patchset 1150: 2012-07-11 19:34:16 +00:00
osdep-aix.c Use pgrp of pty fd not pid of immediate child when recovering current working 2012-09-24 14:05:38 +01:00
osdep-darwin.c Use proc_bsdinfo which works on older OS X versions, from OZAKI Kiichi. 2013-04-10 12:46:29 +01:00
osdep-dragonfly.c Use pgrp of pty fd not pid of immediate child when recovering current working 2012-09-24 14:05:38 +01:00
osdep-freebsd.c Use pgrp of pty fd not pid of immediate child when recovering current working 2012-09-24 14:05:38 +01:00
osdep-hpux.c Use pgrp of pty fd not pid of immediate child when recovering current working 2012-09-24 14:05:38 +01:00
osdep-linux.c Set EVENT_NOEPOLL on Linux again. 2013-08-23 15:25:05 +01:00
osdep-netbsd.c Use pgrp of pty fd not pid of immediate child when recovering current working 2012-09-24 14:05:38 +01:00
osdep-openbsd.c Use open(".")/fchdir() to save and restore current directory rather than 2013-10-05 09:14:11 +01:00
osdep-sunos.c Use pgrp of pty fd not pid of immediate child when recovering current working 2012-09-24 14:05:38 +01:00
osdep-unknown.c Use pgrp of pty fd not pid of immediate child when recovering current working 2012-09-24 14:05:38 +01:00
paste.c Merge branch 'obsd-master' 2012-11-27 22:24:00 +00:00
README The visit -> Visit 2013-02-23 15:15:20 +00:00
resize.c Make recalculate_sizes() handle an empty window with no active pane. This can 2013-08-01 23:37:45 +01:00
screen-redraw.c When only two panes in a window, only draw half the separating line as 2013-03-25 11:41:49 +00:00
screen-write.c Merge branch 'obsd-master' 2013-05-25 11:48:12 +01:00
screen.c Merge branch 'obsd-master' 2013-05-25 11:48:12 +01:00
server-client.c We accidentally haven't been using $TMUX to work out the session for a while 2013-10-06 22:38:33 +01:00
server-fn.c Alter how tmux handles the working directory to internally use file descriptors 2013-10-06 21:02:23 +01:00
server-window.c Add various checks to turn off bits that can't work in control mode (such as 2013-02-17 10:12:55 +00:00
server.c Rename global configuration define. 2013-04-24 10:01:32 +00:00
session.c Alter how tmux handles the working directory to internally use file descriptors 2013-10-06 21:02:23 +01:00
signal.c Expand the Id keyword. 2011-07-09 09:42:33 +00:00
status.c Merge branch 'obsd-master' 2013-07-06 11:18:49 +01:00
SYNCING Move NOTES->README, move Vim syntax file documentation to the file itself and 2013-02-19 23:31:04 +00:00
tmux.1 Alter how tmux handles the working directory to internally use file descriptors 2013-10-06 21:02:23 +01:00
tmux.c We accidentally haven't been using $TMUX to work out the session for a while 2013-10-06 22:38:33 +01:00
tmux.h We accidentally haven't been using $TMUX to work out the session for a while 2013-10-06 22:38:33 +01:00
TODO Remove from TODO. 2013-08-21 18:33:34 +01:00
tty-acs.c Expand the Id keyword. 2011-07-09 09:42:33 +00:00
tty-keys.c Assign mouse x/y coords before checking them 2013-08-20 00:02:38 +01:00
tty-term.c Merge branch 'obsd-master' 2013-06-13 18:12:49 +01:00
tty.c Focus events can cause trouble if left on and they can't be turned off 2013-06-28 20:55:16 +01:00
utf8.c Merge branch 'obsd-master' 2013-04-13 17:05:49 +01:00
window-choose.c choose-tree: Reset top when toggling items 2013-08-20 00:05:28 +01:00
window-clock.c No more lint means no more ARGSUSED. 2013-02-17 23:15:38 +00:00
window-copy.c Merge branch 'obsd-master' 2013-07-13 16:57:51 +01:00
window.c Alter how tmux handles the working directory to internally use file descriptors 2013-10-06 21:02:23 +01:00
xmalloc.c Sync OpenBSD patchset 1150: 2012-07-11 19:34:16 +00:00
xterm-keys.c In terminals with XT, turn on modifyOtherKeys=1 with the escape sequence and 2013-02-17 22:56:12 +00:00

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).

Since the 1.2 release tmux depends on libevent. 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$