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, OS X and Solaris.

Dependencies

tmux depends on libevent 2.x, available from this page.

It also depends on ncurses, available from this page.

Installation

From release tarball

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.

From version control

To get and build the latest from version control:

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

(Note that this requires at least a working C compiler, make, autoconf, automake, pkg-config as well as libevent and ncurses libraries and headers.)

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.

There is a TODO list which explains some ideas for tmux not yet developed. Please feel free to ask for clarifications on the mailing list if you're thinking of working on these or need further information.

Please read the CONTRIBUTING file before opening an issue.

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.

And a bash(1) completion file at:

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

For debugging, run tmux with -v or -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

Name		Name	Last commit message	Last commit date
Latest commit History 7,659 Commits
.github		.github
compat		compat
logo		logo
presentations		presentations
regress		regress
tools		tools
.gitignore		.gitignore
.mailmap		.mailmap
.travis.yml		.travis.yml
CHANGES		CHANGES
COPYING		COPYING
Makefile.am		Makefile.am
README		README
README.ja		README.ja
SYNCING		SYNCING
alerts.c		alerts.c
arguments.c		arguments.c
attributes.c		attributes.c
autogen.sh		autogen.sh
cfg.c		cfg.c
client.c		client.c
cmd-attach-session.c		cmd-attach-session.c
cmd-bind-key.c		cmd-bind-key.c
cmd-break-pane.c		cmd-break-pane.c
cmd-capture-pane.c		cmd-capture-pane.c
cmd-choose-tree.c		cmd-choose-tree.c
cmd-command-prompt.c		cmd-command-prompt.c
cmd-confirm-before.c		cmd-confirm-before.c
cmd-copy-mode.c		cmd-copy-mode.c
cmd-detach-client.c		cmd-detach-client.c
cmd-display-menu.c		cmd-display-menu.c
cmd-display-message.c		cmd-display-message.c
cmd-display-panes.c		cmd-display-panes.c
cmd-find-window.c		cmd-find-window.c
cmd-find.c		cmd-find.c
cmd-if-shell.c		cmd-if-shell.c
cmd-join-pane.c		cmd-join-pane.c
cmd-kill-pane.c		cmd-kill-pane.c
cmd-kill-server.c		cmd-kill-server.c
cmd-kill-session.c		cmd-kill-session.c
cmd-kill-window.c		cmd-kill-window.c
cmd-list-buffers.c		cmd-list-buffers.c
cmd-list-clients.c		cmd-list-clients.c
cmd-list-keys.c		cmd-list-keys.c
cmd-list-panes.c		cmd-list-panes.c
cmd-list-sessions.c		cmd-list-sessions.c
cmd-list-windows.c		cmd-list-windows.c
cmd-list.c		cmd-list.c
cmd-load-buffer.c		cmd-load-buffer.c
cmd-lock-server.c		cmd-lock-server.c
cmd-move-window.c		cmd-move-window.c
cmd-new-session.c		cmd-new-session.c
cmd-new-window.c		cmd-new-window.c
cmd-parse.y		cmd-parse.y
cmd-paste-buffer.c		cmd-paste-buffer.c
cmd-pipe-pane.c		cmd-pipe-pane.c
cmd-queue.c		cmd-queue.c
cmd-refresh-client.c		cmd-refresh-client.c
cmd-rename-session.c		cmd-rename-session.c
cmd-rename-window.c		cmd-rename-window.c
cmd-resize-pane.c		cmd-resize-pane.c
cmd-resize-window.c		cmd-resize-window.c
cmd-respawn-pane.c		cmd-respawn-pane.c
cmd-respawn-window.c		cmd-respawn-window.c
cmd-rotate-window.c		cmd-rotate-window.c
cmd-run-shell.c		cmd-run-shell.c
cmd-save-buffer.c		cmd-save-buffer.c
cmd-select-layout.c		cmd-select-layout.c
cmd-select-pane.c		cmd-select-pane.c
cmd-select-window.c		cmd-select-window.c
cmd-send-keys.c		cmd-send-keys.c
cmd-set-buffer.c		cmd-set-buffer.c
cmd-set-environment.c		cmd-set-environment.c
cmd-set-option.c		cmd-set-option.c
cmd-show-environment.c		cmd-show-environment.c
cmd-show-messages.c		cmd-show-messages.c
cmd-show-options.c		cmd-show-options.c
cmd-source-file.c		cmd-source-file.c
cmd-split-window.c		cmd-split-window.c
cmd-swap-pane.c		cmd-swap-pane.c
cmd-swap-window.c		cmd-swap-window.c
cmd-switch-client.c		cmd-switch-client.c
cmd-unbind-key.c		cmd-unbind-key.c
cmd-wait-for.c		cmd-wait-for.c
cmd.c		cmd.c
colour.c		colour.c
compat.h		compat.h
configure.ac		configure.ac
control-notify.c		control-notify.c
control.c		control.c
environ.c		environ.c
example_tmux.conf		example_tmux.conf
format-draw.c		format-draw.c
format.c		format.c
grid-view.c		grid-view.c
grid.c		grid.c
input-keys.c		input-keys.c
input.c		input.c
job.c		job.c
key-bindings.c		key-bindings.c

License

avih/tmux

Folders and files

Latest commit

History