2007-10-12 17:32:20 +00:00
|
|
|
Welcome to tmux!
|
|
|
|
|
|
2007-10-19 20:43:55 +00:00
|
|
|
tmux is a "terminal multiplexer", it enables a number of terminals (or windows)
|
2007-10-12 17:32:20 +00:00
|
|
|
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.
|
|
|
|
|
|
2007-11-09 16:22:03 +00:00
|
|
|
This 0.1 release should be considered a beta release. It runs on OpenBSD,
|
|
|
|
|
FreeBSD and Linux, but has many missing features and is expected to have a good
|
|
|
|
|
number of bugs.
|
2007-10-12 17:32:20 +00:00
|
|
|
|
|
|
|
|
tmux consists of a server part and multiple clients. The server is created
|
|
|
|
|
when required and runs continuously unless killed by the user. Clients access
|
|
|
|
|
the server through a socket in /tmp. Multiple sessions may be created on a
|
|
|
|
|
single server and attached to a number of clients. Each session may then
|
|
|
|
|
have a number of windows. Commands are available to create, rename and destroy
|
|
|
|
|
windows and sessions; to attach and detach sessions from client terminals;
|
|
|
|
|
to set configuration options; and to bind and unbind command keys (invoked
|
|
|
|
|
preceded by a prefix key, by default ctrl-b). Please see the tmux(1) man page
|
|
|
|
|
for further information.
|
|
|
|
|
|
|
|
|
|
The following is a summary of major features implemented in this version:
|
|
|
|
|
|
|
|
|
|
- Basic multiplexing, window switching, attaching and detaching.
|
|
|
|
|
- Window listing and renaming.
|
|
|
|
|
- Key binding.
|
|
|
|
|
- Handling of client terminal resize.
|
|
|
|
|
- Terminal emulation sufficient to handle most curses applications. Without
|
|
|
|
|
known issues are: emacs, irssi, mutt, ncmpc (resize problems are present in
|
2007-10-19 20:43:55 +00:00
|
|
|
both tmux and screen), vim and various tools and games in the OpenBSD base
|
|
|
|
|
system.
|
2007-10-12 17:32:20 +00:00
|
|
|
- A optional status line (enabled by default).
|
|
|
|
|
|
|
|
|
|
And major missing features:
|
|
|
|
|
|
2007-10-19 20:43:55 +00:00
|
|
|
- Support for VT100 line drawing characters (they will appear as jklmx, etc).
|
|
|
|
|
This is most noticable in ncmpc and in elinks if configured with VT100 frames.
|
2007-10-12 17:32:20 +00:00
|
|
|
- Status line customisation, beyond presence and colour.
|
|
|
|
|
- Copy and paste.
|
|
|
|
|
- Scrollback.
|
|
|
|
|
- Mouse support.
|
2007-11-12 20:59:33 +00:00
|
|
|
- No support for programs changing termios(4) settings or other tty(4) ioctls.
|
2007-10-12 17:32:20 +00:00
|
|
|
|
|
|
|
|
A more extensive, but rough, todo list is included in the TODO file.
|
|
|
|
|
|
|
|
|
|
tmux also depends on several features of the client terminal (TERM), if these
|
2007-11-09 16:22:03 +00:00
|
|
|
are missing it may refuse to run, or not behave correctly. It is possible to
|
|
|
|
|
emulate some of these but tmux does not do this at present. Known working are
|
|
|
|
|
TERM=screen (tmux in screen), xterm, xterm-color and rxvt.
|
2007-10-12 17:32:20 +00:00
|
|
|
|
|
|
|
|
For debugging, running tmux with -v or -vv will generate server and client log
|
2007-11-09 16:22:03 +00:00
|
|
|
files in the current directory.
|
2007-10-12 17:32:20 +00:00
|
|
|
|
2007-11-12 16:13:49 +00:00
|
|
|
Bug reports, feature suggestions and especially code contributions are most
|
|
|
|
|
welcome. Please email:
|
2007-10-12 17:32:20 +00:00
|
|
|
|
|
|
|
|
nicm@users.sf.net
|
|
|
|
|
|
|
|
|
|
Or contact me during UK daytime hours (0900 to 1200 UTC or so) as "NicM" on
|
|
|
|
|
freenode or efnet IRC. I sometimes ignore private msgs from people I don't
|
|
|
|
|
know, so please mention tmux initially (rather than just saying "hi" ;-).
|
|
|
|
|
|
|
|
|
|
-- Nicholas Marriott <nicm@users.sf.net>
|
2007-11-12 20:59:33 +00:00
|
|
|
$Id: NOTES,v 1.26 2007-11-12 20:59:33 nicm Exp $
|
