Go to file
Nicholas Marriott bb210ce773 Add tmux logo, createed by Jason Long. 2015-04-28 13:46:47 +01:00
compat Make place const to avoid a warning, from Ben Boeckel. 2015-03-31 09:26:37 +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 Tweak www and add RELEASE variable for current release version so we don't need 2014-09-16 04:33:34 +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
CHANGES Remove LocalWords. 2015-02-16 17:19:37 +00:00
COPYING Add a COPYING file, suggested by Dagobert Michelsen. 2013-05-31 12:59:17 +01:00
FAQ Use -a for terminal-overrides from Daniel Hahler. 2014-11-06 10:30:05 +00:00
Makefile.am Merge branch 'obsd-master' 2015-04-27 21:21:55 +01:00
README Note libevent version. 2013-12-09 22:53:17 +00:00
SYNCING SYNCING: Make a note about libutils 2014-08-09 20:32:09 +01:00
TODO +. 2015-04-20 08:46:21 +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-04-28 09:10:51 +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 Fix some format specifier nits, from Ben Boeckel. 2015-03-31 17:45:10 +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 Rewrite of the target resolution internals to be simpler and more 2015-04-27 16:25:57 +00:00
cmd-find.c No paths.h on Solaris. 2015-04-28 10:36:17 +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 No need for $Id$ now. 2014-11-08 12:27:43 +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 No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-select-pane.c If the requested pane is already active, do not unzoom the window (or do 2015-04-27 07:49:36 +00:00
cmd-select-window.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
cmd-send-keys.c Rewrite of tmux mouse support which was a mess. Instead of having 2015-04-19 21:34:21 +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-04-25 20:45:02 +00: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 Move the functions to convert ids from strings into session.c and window.c. 2015-04-25 18:09:28 +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 Explicitly look for cpp and egrep to avoid AC_EGREP_CPP messing up output. 2015-03-01 21:46:05 +00: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
environ.c Don't leak the individual strings when copying environment. 2015-01-25 16:53:46 +00:00
format.c Merge branch 'obsd-master' 2015-04-22 10:05:54 +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 use reallocarray instead of calloc; avoid the zero before infill 2015-04-23 07:45:50 +00:00
input-keys.c Merge branch 'obsd-master' 2015-04-22 10:05:54 +01:00
input.c Fix some format specifier nits, from Ben Boeckel. 2015-03-31 17:45:10 +00:00
job.c Merge branch 'obsd-master' 2015-04-25 10:02:46 +00:00
key-bindings.c Fix some char* -> char *. 2015-04-25 18:49:01 +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
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 Rewrite of tmux mouse support which was a mess. Instead of having 2015-04-19 21:34:21 +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-04-20 15:44:27 +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
resize.c Convert clients list into a TAILQ. 2015-04-24 23:17:11 +00:00
screen-redraw.c Support setting the default window and pane background colours (window 2015-04-19 21:05:27 +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 Merge branch 'obsd-master' 2015-04-25 20:45:02 +00:00
server-fn.c Merge branch 'obsd-master' 2015-04-25 10:02:46 +00:00
server-window.c Convert clients list into a TAILQ. 2015-04-24 23:17:11 +00:00
server.c Merge branch 'obsd-master' 2015-04-25 10:02:46 +00:00
session.c Merge branch 'obsd-master' 2015-04-25 20:45:02 +00:00
signal.c No need for $Id$ now. 2014-11-08 12:27:43 +00:00
status.c Make message log a TAILQ. 2015-04-25 18:33:59 +00:00
style.c Fix setting old-style window -fg/-bg/-attr options that aren't global. 2015-04-15 15:44:40 +00:00
tmux.1 Merge branch 'obsd-master' 2015-04-27 21:21:55 +01:00
tmux.c Merge branch 'obsd-master' 2015-02-06 19:07:43 +00:00
tmux.h Merge branch 'obsd-master' 2015-04-27 21:21:55 +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 Explicitly cancel mouse "button" mode, this happens implicitly with some 2015-04-25 15:57:48 +00:00
utf8.c Merge branch 'obsd-master' 2015-04-22 10:05:54 +01:00
window-choose.c Rewrite of tmux mouse support which was a mess. Instead of having 2015-04-19 21:34:21 +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-04-27 21:21:55 +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

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 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$