Go to file
Thomas Adam 4aa02c3743 Merge branch 'obsd-master' 2017-06-07 18:01:13 +01:00
compat Add a small dance to daemon() to reattach tmux to the user's namespace (which 2017-06-06 07:59:53 +01:00
logo Add tmux logo, createed by Jason Long. 2015-04-28 13:46:47 +01:00
presentations Add a couple of presentations I wrote a few years ago. One for the ill-fated 2015-06-04 08:23:40 +01:00
regress Add test for -x and -y too. 2017-05-28 20:15:45 +01:00
tools Differences to OpenBSD. 2017-05-31 16:34:39 +01:00
.gitignore Add *.dSYM for OS X. 2016-06-15 09:51:08 +01:00
.mailmap Add to .mailmap. 2016-07-19 10:42:44 +01:00
.travis.yml TRAVIS-CI: correct path to configure 2015-05-17 14:39:04 +01:00
CHANGES Add a small dance to daemon() to reattach tmux to the user's namespace (which 2017-06-06 07:59:53 +01:00
CONTRIBUTING Update CHANGES. 2017-06-05 12:01:58 +01:00
COPYING Add a COPYING file, suggested by Dagobert Michelsen. 2013-05-31 12:59:17 +01:00
FAQ Tweak title. 2017-06-07 11:27:04 +01:00
ISSUE_TEMPLATE This link is better. 2017-01-26 19:57:16 +00:00
Makefile.am Merge branch 'obsd-master' 2017-05-31 15:56:13 +01:00
README Clarify that release instructions will install. 2017-03-18 08:33:15 +00:00
SYNCING Update release text. 2017-05-29 08:40:33 +01:00
TODO Update TODO. 2017-05-31 17:38:34 +01:00
alerts.c Log what is happening with window and session reference counts much more 2017-04-28 19:13:55 +00:00
arguments.c Merge branch 'obsd-master' 2017-05-31 15:56:13 +01:00
attributes.c Add support for the strikethrough attribute (SGR 9), using the new smxx 2017-03-22 07:16:54 +00:00
autogen.sh Bump automake and autoconf versions. 2017-03-22 08:45:53 +00:00
cfg.c Differences to OpenBSD. 2017-05-31 16:34:39 +01:00
client.c Merge branch 'obsd-master' 2017-01-24 22:01:13 +00:00
cmd-attach-session.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-bind-key.c Bad merge. 2017-01-25 16:38:13 +00:00
cmd-break-pane.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-capture-pane.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-choose-tree.c Rewrite of choose mode, both to simplify and tidy the code and to add 2017-05-30 21:44:59 +00:00
cmd-command-prompt.c Tidy command prompt callbacks and pass in the client. 2017-05-17 15:20:23 +00:00
cmd-confirm-before.c Tidy command prompt callbacks and pass in the client. 2017-05-17 15:20:23 +00:00
cmd-copy-mode.c Rewrite of choose mode, both to simplify and tidy the code and to add 2017-05-30 21:44:59 +00:00
cmd-detach-client.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-display-message.c In order that people can use formats like #D in #() in the status line 2017-05-01 12:20:55 +00:00
cmd-display-panes.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-find-window.c Shut up a warning. 2017-05-31 16:44:33 +00:00
cmd-find.c Merge branch 'obsd-master' 2017-04-22 14:01:15 +01:00
cmd-if-shell.c if-shell doesn't need to queue its error message into a callback, and in 2017-04-25 11:49:35 +00:00
cmd-join-pane.c Merge branch 'obsd-master' 2017-04-22 12:01:19 +01:00
cmd-kill-pane.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-kill-server.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-kill-session.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-kill-window.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-list-buffers.c In order that people can use formats like #D in #() in the status line 2017-05-01 12:20:55 +00:00
cmd-list-clients.c In order that people can use formats like #D in #() in the status line 2017-05-01 12:20:55 +00:00
cmd-list-keys.c In order that people can use formats like #D in #() in the status line 2017-05-01 12:20:55 +00:00
cmd-list-panes.c In order that people can use formats like #D in #() in the status line 2017-05-01 12:20:55 +00:00
cmd-list-sessions.c In order that people can use formats like #D in #() in the status line 2017-05-01 12:20:55 +00:00
cmd-list-windows.c In order that people can use formats like #D in #() in the status line 2017-05-01 12:20:55 +00:00
cmd-list.c I no longer use my SourceForge address so replace it. 2016-01-19 15:59:12 +00:00
cmd-load-buffer.c Memory leaks, from David CARLIER. 2017-04-22 06:13:30 +00:00
cmd-lock-server.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-move-window.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-new-session.c Change so that sessions created detached (-d or no client) are always 2017-05-28 19:46:55 +00:00
cmd-new-window.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-paste-buffer.c Merge branch 'obsd-master' 2017-04-22 12:01:19 +01:00
cmd-pipe-pane.c Merge branch 'obsd-master' 2017-05-01 14:01:14 +01:00
cmd-queue.c Rewrite of choose mode, both to simplify and tidy the code and to add 2017-05-30 21:44:59 +00:00
cmd-refresh-client.c Also recalculate session sizes when refreh-client -C is used. GitHub 2017-05-28 19:00:52 +00:00
cmd-rename-session.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-rename-window.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-resize-pane.c Change how we resolve which pane is dragging when there are multiple 2017-05-11 07:24:42 +00:00
cmd-respawn-pane.c Do not update TERM into config file parsing has finished. 2017-04-25 15:35:10 +00:00
cmd-respawn-window.c Do not update TERM into config file parsing has finished. 2017-04-25 15:35:10 +00:00
cmd-rotate-window.c Set current pane in rotate-window. 2017-05-09 11:00:48 +00:00
cmd-run-shell.c Rewrite of choose mode, both to simplify and tidy the code and to add 2017-05-30 21:44:59 +00:00
cmd-save-buffer.c Merge branch 'obsd-master' 2017-04-22 08:01:54 +01:00
cmd-select-layout.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-select-pane.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-select-window.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-send-keys.c Insert copy mode bindings at the right place in the command queue. 2017-05-10 10:46:59 +00:00
cmd-set-buffer.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd-set-environment.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-set-hook.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-set-option.c Style and spacing nits. 2017-05-31 17:56:48 +00:00
cmd-show-environment.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-show-messages.c Merge branch 'obsd-master' 2017-04-22 12:01:19 +01:00
cmd-show-options.c Merge branch 'obsd-master' 2017-05-10 16:01:10 +01:00
cmd-source-file.c load_cfg returns < 0 on error, not != 0. Problem reported by Kaushal Modi. 2017-04-19 22:19:22 +01:00
cmd-split-window.c Merge branch 'obsd-master' 2017-05-31 15:56:13 +01:00
cmd-string.c Add support for custom command aliases, this is an array option which 2017-01-24 19:53:37 +00:00
cmd-swap-pane.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-swap-window.c Get rid of the extra layer of flags and cmd_prepare() and just store the 2017-04-22 10:22:39 +00:00
cmd-switch-client.c Some new notifications, mainly for active pane and current window and 2017-05-04 07:16:43 +00:00
cmd-unbind-key.c Bad merge. 2017-01-25 16:38:13 +00:00
cmd-wait-for.c Mass rename struct cmd_q to struct cmdq_item and related. 2016-10-16 19:04:05 +00:00
cmd.c Merge branch 'obsd-master' 2017-05-31 15:56:13 +01:00
colour.c Show count of search results in copy mode. 2017-03-24 07:14:27 +00:00
compat.h Do not need getopt.h for getopt, from Eric N Vander Weele. 2017-04-20 20:35:11 +01:00
configure.ac Add a small dance to daemon() to reattach tmux to the user's namespace (which 2017-06-06 07:59:53 +01:00
control-notify.c Some new notifications, mainly for active pane and current window and 2017-05-04 07:16:43 +00:00
control.c It is silly for cmd_list_parse to return an integer error when it could 2017-01-15 22:00:56 +00:00
environ.c Make environ_log prefix take a format. 2017-05-11 07:34:54 +00:00
example_tmux.conf 15 minutes is not 1800 seconds, but just remove lock-after-time because it won't work for Linux folks without additional configuration 2017-01-10 19:33:22 +00:00
format.c Merge branch 'obsd-master' 2017-06-01 18:29:36 +01:00
grid-view.c Scrolling needs to use background colour. 2017-05-12 13:00:56 +00:00
grid.c Line length and spaces to tabs. 2017-05-16 12:57:26 +00:00
hooks.c Provide a way for hooks to tag formats onto the commands they fire so 2016-10-16 19:36:37 +00:00
input-keys.c Merge branch 'obsd-master' 2017-05-09 15:44:13 +01:00
input.c Add a timeout to prevent the sequences which wait for a specific 2017-06-04 09:22:34 +00:00
job.c Merge branch 'obsd-master' 2017-06-01 18:29:36 +01:00
key-bindings.c Rewrite of choose mode, both to simplify and tidy the code and to add 2017-05-30 21:44:59 +00:00
key-string.c Minor bits: fix an array size, add comment, make grid_cell_entry static. 2017-02-22 09:01:32 +00:00
layout-custom.c Use the notify name string instead of going via an enum and change 2016-10-16 22:06:40 +00:00
layout-set.c Notify layout changed when choosing predefined layouts, from Joshua Brot. 2017-05-15 14:57:29 +00:00
layout.c Fix calculation of size for full size splits. 2017-03-11 15:16:35 +00:00
log.c Merge branch 'obsd-master' 2017-06-05 11:59:38 +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-tree.c Return 1 if name matches not 0, also fix some spaces. 2017-06-07 15:27:46 +00:00
names.c In order that people can use formats like #D in #() in the status line 2017-05-01 12:20:55 +00:00
notify.c Merge branch 'obsd-master' 2017-05-04 10:01:12 +01:00
options-table.c Merge branch 'obsd-master' 2017-06-03 20:01:10 +01:00
options.c Style and spacing nits. 2017-05-31 17:56:48 +00:00
osdep-aix.c Update my email address. 2016-01-19 18:07:25 +00:00
osdep-cygwin.c Update my email address. 2016-01-19 18:07:25 +00:00
osdep-darwin.c Apple have changed their API again, from Gregory Pakosz. 2016-09-12 11:06:35 +01:00
osdep-dragonfly.c Update my email address. 2016-01-19 18:07:25 +00:00
osdep-freebsd.c Update my email address. 2016-01-19 18:07:25 +00:00
osdep-hpux.c Update my email address. 2016-01-19 18:07:25 +00:00
osdep-linux.c Update my email address. 2016-01-19 18:07:25 +00:00
osdep-netbsd.c Improve NetBSD KERN_PROC2 bit, mostly from Kamil Rytarowski. 2017-02-19 08:31:05 +00:00
osdep-openbsd.c Merge branch 'obsd-master' 2016-10-12 09:45:49 +01:00
osdep-sunos.c Some __unused. 2017-03-21 19:27:18 +00:00
osdep-unknown.c Update my email address. 2016-01-19 18:07:25 +00:00
paste.c Merge branch 'obsd-master' 2017-01-24 14:01:15 +00:00
proc.c Merge branch 'obsd-master' 2017-06-07 18:01:13 +01:00
resize.c Prevent control clients from affecting the session size until they have 2017-05-10 16:48:36 +00:00
screen-redraw.c In order that people can use formats like #D in #() in the status line 2017-05-01 12:20:55 +00:00
screen-write.c Typo/style; plus man page escaping from jmc. 2017-06-04 08:02:20 +00:00
screen.c Linux build fixes 2017-06-05 12:00:52 +01:00
server-client.c Merge branch 'obsd-master' 2017-06-06 18:01:13 +01:00
server-fn.c Merge branch 'obsd-master' 2017-05-12 16:01:14 +01:00
server.c Merge branch 'obsd-master' 2017-06-05 11:59:38 +01:00
session.c Merge branch 'obsd-master' 2017-05-04 10:01:12 +01:00
signal.c Support SIGUSR2 to stop and start logging for an existing server. Also 2017-06-04 08:25:57 +00:00
status.c Add a flag to stop the prompt input being expanded. 2017-05-29 20:42:53 +00:00
style.c Add support for the strikethrough attribute (SGR 9), using the new smxx 2017-03-22 07:16:54 +00:00
tmux.1 Merge branch 'obsd-master' 2017-06-07 16:01:10 +01:00
tmux.c Do not need getopt.h. 2017-04-22 12:08:41 +00:00
tmux.h Merge branch 'obsd-master' 2017-06-07 18:01:13 +01:00
tty-acs.c Check the terminfo(5) U8 capability and disable using UTF-8 for ACS if 2017-05-15 16:44:04 +00:00
tty-keys.c Up to now, tmux sees \033\033[OA as M-Up and since we turned on 2017-05-07 21:25:59 +00:00
tty-term.c tparm() fix for Solaris. 2017-06-04 11:27:35 +01:00
tty.c Delete input event when evbuffer_read() fails to avoid just spinning 2017-06-06 14:53:28 +00:00
utf8.c Merge branch 'obsd-master' 2017-06-05 11:59:38 +01:00
window-buffer.c Merge branch 'obsd-master' 2017-06-07 18:01:13 +01:00
window-client.c Add simple searching (C-s and n) to the various choose modes: by name 2017-06-07 14:37:30 +00:00
window-clock.c Rewrite of choose mode, both to simplify and tidy the code and to add 2017-05-30 21:44:59 +00:00
window-copy.c Make set-clipboard a three-state option so tmux itself can ignore the 2017-06-03 17:43:01 +00:00
window-tree.c Use osdep_get_name. 2017-06-07 16:21:01 +01:00
window.c Merge branch 'obsd-master' 2017-06-05 11:59:38 +01:00
xmalloc.c Key running commands for #() by the unexpanded command, and run them 2016-11-17 10:06:08 +00:00
xmalloc.h Merge branch 'obsd-master' 2016-11-17 12:01:10 +00:00
xterm-keys.c Up to now, tmux sees \033\033[OA as M-Up and since we turned on 2017-05-07 21:25:59 +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, OS X and Solaris.

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

	http://libevent.org

It also depends on ncurses, available from:

	http://invisible-island.net/ncurses/

To build and install tmux from a release tarball, use:

	$ ./configure && make
	$ sudo make install

tmux can use the utempter library to update utmp(5), if it is installed - run
configure with --enable-utempter to enable this.

To get and build the latest from version control:

	$ git clone https://github.com/tmux/tmux.git
	$ cd tmux
	$ sh autogen.sh
	$ ./configure && make

For more information see http://git-scm.com. Patches should be sent by email to
the mailing list at tmux-users@googlegroups.com.

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, a rough todo list is in the
TODO file and an example configuration in example_tmux.conf.

A vim(1) syntax file is available at:

	https://github.com/ericpruitt/tmux.vim
	https://raw.githubusercontent.com/ericpruitt/tmux.vim/master/vim/syntax/tmux.vim

And a bash(1) completion file at:

	https://github.com/imomaliev/tmux-bash-completion

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

tmux mailing lists are available. For general discussion and bug reports:

	https://groups.google.com/forum/#!forum/tmux-users

And for Git commit emails:

	https://groups.google.com/forum/#!forum/tmux-git

Subscribe by sending an email to <tmux-users+subscribe@googlegroups.com>.

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

	tmux-users@googlegroups.com

This file and the CHANGES, FAQ, SYNCING and TODO files are licensed under the
ISC license. All other files have a license and copyright notice at their start.

-- Nicholas Marriott <nicholas.marriott@gmail.com>