You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Thomas Adam 9ef854f5a9 Merge branch 'obsd-master' 5 days ago
.github Add permissions for workflow, GitHub issue 3202. 3 months ago
compat Add headers and fix type, from Marvin Schmidt. GitHub issue 3332. 2 weeks ago
fuzz Needs fcntl.h. 1 year ago
logo Icons, from someone on GitHub in issue 2870. 1 year ago
presentations Add a couple of presentations I wrote a few years ago. One for the ill-fated 7 years ago
regress Regress typos. 4 weeks ago
tools Typos from Bastian Venthur. 4 months ago
.gitignore Scaffold for oss-fuzz, from Sergey Nizovtsev. 2 years ago
.mailmap Add to .mailmap. 6 years ago
.travis.yml Add FreeBSD CI, from Jan Beich. 2 years ago
CHANGES Typos from Bastian Venthur. 4 months ago
COPYING There is no examples directory anymore. 4 years ago
Makefile.am Merge branch 'obsd-master' 3 months ago
README OS X -> macOS, from J Lewis Muir. 11 months ago
README.ja OS X -> macOS, from J Lewis Muir. 11 months ago
SYNCING Minor cleanups, GitHub issue 2824. 1 year ago
alerts.c Merge branch 'obsd-master' into master 1 year ago
arguments.c Merge branch 'obsd-master' 2 months ago
attributes.c Add an attribute for ACS. 2 years ago
autogen.sh Bump automake and autoconf versions. 6 years ago
cfg.c Merge branch 'obsd-master' 3 months ago
client.c Add an ACL list for users connecting to the tmux socket. Users may be 4 months ago
cmd-attach-session.c Show config errors on attach if they were not shown when the session 3 months ago
cmd-bind-key.c Replace %% in command lists (by copying them) for template arguments , 1 year ago
cmd-break-pane.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-capture-pane.c Add a -T flag to capture-pane to stop at the last used cell instead of 5 days ago
cmd-choose-tree.c When picking a buffer because one isn't specified by the user, ignore 4 months ago
cmd-command-prompt.c Spacing/style nits. 4 months ago
cmd-confirm-before.c Expand command as a format, GitHub issue 2920. 11 months ago
cmd-copy-mode.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-detach-client.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-display-menu.c Merge branch 'obsd-master' into master 11 months ago
cmd-display-message.c Handle splitw -I correctly when used from an attached client, GitHub 1 year ago
cmd-display-panes.c Add support for OSC 8 hyperlinks (a VTE extension now supported by other 3 months ago
cmd-find-window.c Preserve argument type in command and convert to string on demand. 1 year ago
cmd-find.c Add a client flag 'active-pane' which stores the active pane in the 2 years ago
cmd-if-shell.c Add -e flag to set environment for popup, from Alexis Hildebrandt in 12 months ago
cmd-join-pane.c Merge branch 'obsd-master' 4 months ago
cmd-kill-pane.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-kill-server.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-kill-session.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-kill-window.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-list-buffers.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-list-clients.c Add formats for client and server UID and user (for multiuser setups). 6 months ago
cmd-list-keys.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-list-panes.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-list-sessions.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-list-windows.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-load-buffer.c If an application gives the first parameter to OSC 52, validate and pass 4 months ago
cmd-lock-server.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-move-window.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-new-session.c Show config errors on attach if they were not shown when the session 3 months ago
cmd-new-window.c Replace %% in command lists (by copying them) for template arguments , 1 year ago
cmd-parse.y Disable aliases inside aliases for the moment. 1 year ago
cmd-paste-buffer.c Merge branch 'obsd-master' into master 1 year ago
cmd-pipe-pane.c Do not allow pipe-pane on dead panes, from Anindya Mukherjee, GitHub 4 months ago
cmd-queue.c Add a way for lines added to copy mode to be passed through the parser 4 months ago
cmd-refresh-client.c Spacing/style nits. 4 months ago
cmd-rename-session.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-rename-window.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-resize-pane.c Adjust size given to resize-pane for pane status line, GitHub issue 6 months ago
cmd-resize-window.c Allow control mode clients to set a hard limit on the window width and 1 year ago
cmd-respawn-pane.c Replace %% in command lists (by copying them) for template arguments , 1 year ago
cmd-respawn-window.c Replace %% in command lists (by copying them) for template arguments , 1 year ago
cmd-rotate-window.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-run-shell.c Do not attempt to use client in config file (it will be NULL), GitHub 4 months ago
cmd-save-buffer.c Merge branch 'obsd-master' into master 1 year ago
cmd-select-layout.c Better error reporting when applying custom layouts. 4 months ago
cmd-select-pane.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-select-window.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-send-keys.c Expand arguments to some commands where it makes sense, GitHub issue 4 months ago
cmd-server-access.c Add a missing space. 4 months ago
cmd-set-buffer.c If an application gives the first parameter to OSC 52, validate and pass 4 months ago
cmd-set-environment.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-set-option.c Validate command argument types (string or command list) and give more 1 year ago
cmd-show-environment.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-show-messages.c Merge branch 'obsd-master' into master 1 year ago
cmd-show-options.c Do not return error with -q, GitHub issue 3065. 6 months ago
cmd-show-prompt-history.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-source-file.c Merge branch 'obsd-master' into master 1 year ago
cmd-split-window.c Merge branch 'obsd-master' 4 months ago
cmd-swap-pane.c Emit window-layout-changed on swap-pane, from George Nachman. 4 months ago
cmd-swap-window.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-switch-client.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-unbind-key.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd-wait-for.c Add args parsing callback for some future work, currently unused. 1 year ago
cmd.c Add an ACL list for users connecting to the tmux socket. Users may be 4 months ago
colour.c Add unit (milliseconds) to escape-time, show unset colours as "none" 6 months ago
compat.h Add support for systemd socket activation (where systemd creates the Unix 6 months ago
configure.ac Check for $YACC, from Wei Shih in GitHub issue 3267. 2 months ago
control-notify.c Notify when a paste buffer is deleted, GitHub issue 3302 from George 2 months ago
control.c Merge branch 'obsd-master' 1 month ago
environ.c Don't stop at first match when updating environment. 2 months ago
example_tmux.conf Minor cleanups, GitHub issue 2824. 1 year ago
file.c Merge branch 'obsd-master' 1 month ago
format-draw.c Initialize copy_width before adjusting it, GitHub issue 3079. 6 months ago
format.c Merge branch 'obsd-master' 3 months ago
grid-reader.c back-to-indentation fixes, from Anindya Mukherjee. 1 year ago
grid-view.c Add a -T flag to capture-pane to stop at the last used cell instead of 5 days ago
grid.c Add a -T flag to capture-pane to stop at the last used cell instead of 5 days ago
hyperlinks.c Merge branch 'obsd-master' 3 months ago
input-keys.c If a mouse position was above the maximum supported by the normal mouse 4 months ago
input.c Don't use options from pane if pane is NULL. 3 weeks ago
job.c Merge branch 'obsd-master' into master 8 months ago
key-bindings.c Add scroll-middle copy mode command to make cursor line in the middle, 1 month ago
key-string.c Support more mouse buttons when the terminal sends them, GitHub issue 6 months ago
layout-custom.c Better error reporting when applying custom layouts. 4 months ago
layout-set.c Add split-window -Z to start the pane zoomed, GitHub issue 2591. 2 years ago
layout.c Add split-window -Z to start the pane zoomed, GitHub issue 2591. 2 years ago
log.c Spacing/style nits. 4 months ago
mdoc2man.awk Generate tmux.1 using mdoc2man.awk on Solaris, issue brought up and changes 10 years ago
menu.c Change g and G to go to top and bottom of menu, GitHub issue 3286. 2 months ago
mode-tree.c A menu must be shown on a client, so always give the client when adding 8 months ago
names.c Remove stray spaces after function names. 1 year ago
notify.c Merge branch 'obsd-master' 2 months ago
options-table.c Merge branch 'obsd-master' 1 week ago
options.c Check cursor options when a pane is created, not just when they are changed. 4 months ago
osdep-aix.c Update my email address. 7 years ago
osdep-cygwin.c Look for libevent2 differently from libevent for platforms with both. 2 years ago
osdep-darwin.c +compat.h 2 years ago
osdep-dragonfly.c Look for libevent2 differently from libevent for platforms with both. 2 years ago
osdep-freebsd.c Look for libevent2 differently from libevent for platforms with both. 2 years ago
osdep-haiku.c Look for libevent2 differently from libevent for platforms with both. 2 years ago
osdep-hpux.c Look for libevent2 differently from libevent for platforms with both. 2 years ago
osdep-linux.c Look for libevent2 differently from libevent for platforms with both. 2 years ago
osdep-netbsd.c Remove unnecessary declarations. 6 months ago
osdep-openbsd.c Use PATH_MAX instead of MAXPATHLEN. 6 months ago
osdep-sunos.c Looks like evports on SunOS are broken also, disable them. GitHub issue 2702. 1 year ago
osdep-unknown.c Look for libevent2 differently from libevent for platforms with both. 2 years ago
paste.c Merge branch 'obsd-master' 2 months ago
popup.c Use correct size for screen when popup is created without borders. 6 months ago
proc.c Add an ACL list for users connecting to the tmux socket. Users may be 4 months ago
regsub.c Some minor style nits. 3 years ago
resize.c Add a window-resized hook which is fired when the window is actually 6 months ago
screen-redraw.c Add support for OSC 8 hyperlinks (a VTE extension now supported by other 3 months ago
screen-write.c Add a third state "all" to allow-passthrough to work even in invisible 2 months ago
screen.c Merge branch 'obsd-master' 3 months ago
server-acl.c Spacing/style nits. 4 months ago
server-client.c Merge branch 'obsd-master' 3 months ago
server-fn.c Add remain-on-exit-format to set text shown when pane is dead. 6 months ago
server.c Merge branch 'obsd-master' 3 months ago
session.c Do not attempt to update focus (and crash) when there is no previous window. 6 months ago
spawn.c Merge branch 'obsd-master' 2 months ago
status.c Use correct option name. 3 weeks ago
style.c Add support for OSC 8 hyperlinks (a VTE extension now supported by other 3 months ago
tmux-protocol.h Break message type stuff out into its own header. 1 year ago
tmux.1 Merge branch 'obsd-master' 5 days ago
tmux.c Some style nits. 6 months ago
tmux.h Merge branch 'obsd-master' 5 days ago
tty-acs.c Spacing fixes from Alexis Hildebrandt. 12 months ago
tty-features.c Merge branch 'obsd-master' 2 months ago
tty-keys.c Process modifiers as bits rather than using a switch, from Koichi Murase. 3 months ago
tty-term.c Merge branch 'obsd-master' 2 months ago
tty.c Add a Nobr terminfo capability to tell tmux the terminal does not use 2 months ago
utf8.c Remove fallback for wcwidth failure, GitHub issue 3003. 10 months ago
window-buffer.c Spacing/style nits. 4 months ago
window-client.c Spacing/style nits. 4 months ago
window-clock.c Do not hoke into struct window_pane from the tty code and instead set 2 years ago
window-copy.c Add scroll-top and scroll-bottom commands to scroll so cursor is at top 5 days ago
window-customize.c Add unit (milliseconds) to escape-time, show unset colours as "none" 6 months ago
window-tree.c Merge branch 'obsd-master' 3 months ago
window.c Merge branch 'obsd-master' 1 month ago
xmalloc.c Add xrecallocarray. 3 years ago
xmalloc.h Merge branch 'obsd-master' into master 1 year ago

README

Welcome to tmux!

tmux is a terminal multiplexer: it enables a number of terminals to be created,
accessed, and controlled from a single screen. tmux may be detached from a
screen and continue running in the background, then later reattached.

This release runs on OpenBSD, FreeBSD, NetBSD, Linux, macOS and Solaris.

* Dependencies

tmux depends on libevent 2.x, available from:

https://github.com/libevent/libevent/releases/latest

It also depends on ncurses, available from:

https://invisible-mirror.net/archives/ncurses/

To build tmux, a C compiler (for example gcc or clang), make, pkg-config and a
suitable yacc (yacc or bison) are needed.

* Installation

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 - note that this requires
autoconf, automake and pkg-config:

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

* Contributing

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

tmux-users@googlegroups.com

Or open a GitHub issue or pull request.

* Documentation

For documentation on using tmux, see the tmux.1 manpage. View it from the
source tree with:

$ nroff -mdoc tmux.1|less

A small example configuration is in example_tmux.conf.

Other documentation is available in the wiki:

https://github.com/tmux/tmux/wiki

Also see the tmux FAQ at:

https://github.com/tmux/tmux/wiki/FAQ

A bash(1) completion file is at:

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

For debugging, run tmux with -v and -vv to generate server and client log files
in the current directory.

* Support

The tmux mailing list for general discussion and bug reports is:

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

Subscribe by sending an email to:

tmux-users+subscribe@googlegroups.com

* License

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