Instant Terminal Sharing
Go to file
Nicholas Marriott e9b09faab2 We accidentally haven't been using $TMUX to work out the session for a while
and in fact it is less useful that using the client ttyname. So don't bother
and don't pass it from the client. If we need it in future it is in c->environ.
2013-10-06 22:38:33 +01:00
compat +strings.h in compat/. 2013-06-25 09:57:49 +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-03-24 09:54:10 +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 Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-respawn-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +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 support for Cgywin, apparently it is enough just to open the tty again in 2013-07-12 22:21:42 +01:00
configure.ac Check setupterm() in libtinfo also 2013-10-05 12:44:29 +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 Merge branch 'obsd-master' 2013-04-23 08:26:04 +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 2013-03-22 10:30:04 +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 Use _XPG6 on Solaris with GCC because the headers are insane and don't like GCC 2013-06-25 09:35:42 +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-03-22 10:31:22 +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 2013-03-22 10:30:04 +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$