tmux Changelog

What's new in tmux 2.3

Nov 20, 2016
  • New option 'pane-border-status' to add text in the pane borders.
  • Support for hooks on commands: 'after' and 'before' hooks.
  • 'source-file' understands '-q' to suppress errors for nonexistent files.
  • Lots of UTF8 improvements, especially on MacOS.
  • 'window-status-separator' understands #[] expansions.
  • 'split-window' understands '-f' for performing a full-width split.
  • Allow report count to be specified when using 'bind-key -R'.
  • 'set -a' for appending to user options (@foo) is now supported.
  • 'display-panes' can now accept a command to run, rather than always selecting the pane.

New in tmux 2.2 (Aug 1, 2016)

  • INCOMPATIBLE CHANGES:
  • The format strings which referenced time have been removed. Instead #{t:window_activity} can be used.
  • Support for TMPDIR has been removed. Use TMUX_TMPDIR instead.
  • UTF8 detection how happens automatically if the client supports it, hence
  • the mouse-utf8 and utf8 options has been removed.
  • The mouse_utf8_flag format string has been removed.
  • The -I option to show-messages has been removed. See #{t:start_time} format option instead.
  • NORMAL CHANGES:
  • Panes are unzoomed with selectp -LRUD
  • Job output is run via the format system, so formats work again
  • If display-time is set to 0, then the indicators wait for a key to be pressed.
  • list-keys and list-commands can be run without starting the tmux server.
  • kill-session learns -C to clear all alerts in all windows of the session.
  • RGB (24bit) colour support. The 'Tc' flag must be set in the external TERM entry (using terminal-overrides or a custom terminfo entry).
  • Support for hooks (internal for now), but hooks for the following have been implemented:
  • alert-bell
  • alert-silence
  • alert-activity
  • client-attached
  • client-detached
  • client-resized
  • pane-died
  • pane-exited
  • New formats added:
  • #{scroll_position}
  • #{socket_path}
  • #{=10:...} -- limit to N characters (from the start)
  • #{=-10:...} -- limit to N characters (from the end)
  • #{t:...} -- used to format time-based formats
  • #{b:...} -- used to ascertain basename from string
  • #{d:...} -- used to ascertain dirname from string
  • #{s:...} -- used to perform substitutions on a string

New in tmux 2.0 (May 12, 2015)

  • INCOMPATIBLE CHANGES:
  • The choose-list command has been removed.
  • 'terminal-overrides' is now a server option, not a session option.
  • 'message-limit' is now a server option, not a session option.
  • 'monitor-content' option has been removed.
  • 'pane_start_path' option has been removed.
  • The "info" mechanism which used to (for some commands) provide feedback has been removed, and like other commands, they now produce nothing on success.
  • NORMAL CHANGES:
  • tmux can now write an entry to utmp if the library 'utempter' is present at compile time.
  • set-buffer learned append mode (-a), and a corresponding 'append-selection' command has been added to copy-mode.
  • choose-mode now has the following commands which can be bound: - start-of-list - end-of-list - top-line - bottom-line
  • choose-buffer now understands UTF-8.
  • Pane navigation has changed: - The old way of always using the top or left if the choice is ambiguous. - The new way of remembering the last used pane is annoying if the layout is balanced and the leftmost is obvious to the user (because clearly if we go right from the top-left in a tiled set of four we want to end up in top-right, even if we were last using the bottom-right). So instead, use a combination of both: if there is only one possible pane alongside the current pane, move to it, otherwise choose the most recently used of the choice.
  • 'set-buffer' can now be told to give names to buffers.
  • The 'new-session', 'new-window', 'split-window', and 'respawn-pane' commands now understand multiple arguments and handle quoting problems correctly.
  • 'capture-pane' understands '-S-' to mean the start of the pane, and '-E-' to mean the end of the pane.
  • Support for function keys beyond F12 has changed. The following explains: - F13-F24 are S-F1 to S-F12 - F25-F36 are C-F1 to C-F12 - F37-F48 are C-S-F1 to C-S-F12 - F49-F60 are M-F1 to M-F12 - F61-F63 are M-S-F1 to M-S-F3 Therefore, F13 becomes a binding of S-F1, etc.
  • Support using pane id as part of session or window specifier (so % means session-of-%1 or window-of-%1) and window id as part of session (so @1 means session-of-@1).
  • 'copy-pipe' command now understands formats via -F
  • 'if-shell' command now understands formats via -F
  • 'split-window' and 'join-window' understand -b to create the pane to the left or above the target pane

New in tmux 1.8 (Mar 27, 2013)

  • Add halfpage up/down bindings to copy mode.
  • Session choosing fixed to work with unattached sessions.
  • New window options window-status-last-{attr,bg,fg} to denote the last
  • window which was active.
  • Scrolling in copy-mode now scrolls the region without moving the mouse
  • cursor.
  • run-shell learnt '-t' to specify the pane to use when displaying output.
  • Support for middle-click pasting.
  • choose-tree learns '-u' to start uncollapsed.
  • select-window learnt '-T; to toggle to the last window if it's already
  • current.
  • New session option 'assume-paste-time' for pasting text versus key-binding
  • actions.
  • choose-commands now work outside of an attached client.
  • Aliases are now shown for list-commands command.
  • Status learns about formats.
  • Free-form options can be set with set-option if prepended with an '@'
  • sign.
  • capture-pane learnt '-p' to send to stdout, and '-e' for capturing escape
  • sequences, and '-a' to capture the alternate screen, and '-P' to dump
  • pending output.
  • Many new formats added (client_session, client_last_session, etc.)
  • Control mode, which is a way for a client to send tmux commands.
  • Currently more useful to users of iterm2.
  • resize-pane learnt '-x' and '-y' for absolute pane sizing.
  • Config file loading now reports errors from all files which are loaded via
  • the 'source-file' command.
  • 'copy-pipe' mode command to copy selection and pipe the selection to a
  • command.
  • Changes panes can now emit focus notifications for certain applications
  • which use those.
  • run-shell and if-shell now accept format placeholders.
  • resize-pane learnt '-Z' for zooming a pane temporarily.
  • new-session learnt '-A' to make it behave like attach-session.
  • set-option learnt '-o' to prevent setting an option which is already set.
  • capture-pane and show-options learns '-q' to silence errors.
  • New command 'wait-for' which blocks a client until woken up again.
  • Resizing panes will now reflow the text inside them.
  • Lots and lots of bug fixes, fixing memory-leaks, etc.
  • Various manpage improvements.

New in tmux 1.6 (Jan 23, 2012)

  • Extend the mode-mouse option to add a third choice which means the mouse
  • does not enter copy mode.
  • Add a -r flag to switch-client to toggle the client read-only flag.
  • Add pane-base-index option.
  • Support \ for line continuation in the configuration file.
  • Framework for more powerful formatting of command output and use it for
  • list-{panes,windows,sessions}. This allows more descriptive replacements
  • (such as #{session_name}) and conditionals.
  • Mark dead panes with some text saying they are dead.
  • Reject $SHELL if it is not a full path.
  • Add -S option to refresh-client to redraw status line.
  • Add an else clause for if-shell.
  • Try to resolve relative paths for loadb and saveb (first, using client
  • working directory, if any, then default-path or session working directory).
  • Support for \e[3J to clear the history and send the corresponding
  • terminfo code (E3) before locking.
  • When in copy mode, make repeat count indicate buffer to replace, if used.
  • Add screen*:XT to terminal-overrides for tmux-in-tmux.
  • Status-line message attributes added.
  • Move word-separators to be a session rather than window option.
  • Change the way the working directory for new processes is discovered. If
  • default-path isn't empty, it is used. Otherwise, if a new window is created
  • from the command-line, the working directory of the client is used. If not,
  • platform specific code is used to retrieve the current working directory
  • of the process in the active pane. If that fails, the directory where the
  • session was created is used, instead.
  • Do not change the current pane if both mouse-select-{pane,window} are
  • enabled.
  • Add \033[s and \033[u to save and restore cursor position.
  • Allow $HOME to be used as default-path.
  • Add CNL and CPL escape sequences.
  • Calculate last position correctly for UTF-8 wide characters.
  • Add an option allow-rename to disable the window rename escape sequence.
  • Attributes for each type of status-line alert (ie bell, content and
  • activity) added. Therefore, remove the superfluous options
  • window-status-alert-{attr,bg,fg}.
  • Add a -R flag to send-keys to reset the terminal.
  • Add strings to allow the aixterm bright colours to be used when
  • configuring colours.
  • Drop the ability to have a list of keys in the prefix in favour of two
  • separate options, prefix and prefix2.
  • Flag -2 added to send-prefix to send the secondary prefix key.
  • Show pane size in top right of display panes mode.
  • Some memory leaks plugged.
  • More command-prompt editing improvements.
  • Various manpage improvements.
  • More Vi mode improvements.

New in tmux 1.5 (Jul 11, 2011)

  • Support xterm mouse modes 1002 and 1003.
  • Change from a per-session stack of buffers to one global stack. This renders
  • copy-buffer useless and makes buffer-limit now a server option.
  • Fix most-recently-used choice by avoiding reset the activity timer for
  • unattached sessions every second.
  • Add a -P option to new-window and split-window to print the new window or
  • pane index in target form (useful to pass it into other commands).
  • Handle a # at the end of a replacement string (such as status-left)
  • correctly.
  • Support for UTF-8 mouse input (\033[1005h) which was added in xterm 262.
  • If the new mouse-utf8 option is on, UTF-8 mouse input is enabled for all
  • UTF-8 terminals. The option defaults to on if LANG etc are set in the same
  • manner as the utf8 option.
  • Support for HP-UX.
  • Accept colours of the hex form #ffffff and translate to the nearest from the
  • xterm(1) 256-colour set.
  • Clear the non-blocking IO flag (O_NONBLOCK) on the stdio file descriptors
  • before closing them (fixes things like "tmux ls && cat").
  • Use TMPDIR if set.
  • Fix next and previous session functions to actually work.
  • Support -x and -y for new-session to specify the initial size of the window
  • if created detached with -d.
  • Make bind-key accept characters with the top-bit-set and print them as octal.
  • Set $TMUX without the session when background jobs are run.
  • Simplify the way jobs work and drop the persist type, so all jobs are
  • fire-and-forget.
  • Accept tcgetattr/tcsetattr(3) failure, fixes problems with fatal() if the
  • terminal disappears while locked.
  • Add a -P option to detach to HUP the client's parent process (usually causing
  • it to exit as well).
  • Support passing through escape sequences to the underlying terminal by using
  • DCS with a "tmux;" prefix.
  • Prevent tiled producing a corrupt layout when only one column is needed.
  • Give each pane created in a tmux server a unique id (starting from 0), put it
  • in the TMUX_PANE environment variable and accept it as a target.
  • Allow a start and end line to be specified for capture-pane which may be
  • negative to capture part of the history.
  • Add -a and -s options to lsp to list all panes in the server or session
  • respectively. Likewise add -s to lsw.
  • Change -t on display-message to be target-pane for the #[A-Z] replacements
  • and add -c as target-client.
  • The attach-session command now prefers the most recently used unattached
  • session.
  • Add -s option to detach-client to detach all clients attached to a session.
  • Add -t to list-clients.
  • Change window with mouse wheel over status line if mouse-select-window is on.
  • When mode-mouse is on, automatically enter copy mode when the mouse is
  • dragged or the mouse wheel is used. Also exit copy mode when the mouse wheel
  • is scrolled off the bottom.
  • Provide #h character pair for short hostname (no domain).
  • Don't use strnvis(3) for the title as it breaks UTF-8.
  • Use the tsl and fsl terminfo(5) capabilities to update terminal title and
  • automatically fill them in on terminals with the XT capability (which means
  • their title setting is xterm-compatible).
  • Add a new option, mouse-resize-pane. When on, panes may be resized by
  • dragging their borders.
  • Fix crash by resetting last pane on {break,swap}-pane across windows.
  • Add three new copy-mode commands - select-line, copy-line, copy-end-of-line.
  • Support setting the xterm clipboard when copying from copy mode using the
  • xterm escape sequence for the purpose (if xterm is configured to allow it).
  • Support xterm(1) cursor colour change sequences through terminfo(5) Cc
  • (set) and Cr (reset) extensions.
  • Support DECSCUSR sequence to set the cursor style with two new terminfo(5)
  • extensions, Cs and Csr.
  • Make the command-prompt custom prompts recognize the status-left option
  • character pairs.
  • Add a respawn-pane command.
  • Add a couple of extra xterm-style keys that gnome terminal provides.
  • Allow the initial context on prompts to be set with the new -I option to
  • command-prompt. Include the current window and session name in the prompt
  • when renaming and add a new key binding ($) for rename session.
  • Option bell-on-alert added to trigger the terminal bell when there is an
  • alert.
  • Change the list-keys format so that it shows the keys using actual tmux
  • commands which should be able to be directly copied into the config file.
  • Show full targets for lsp/lsw -a.
  • Make confirm-before prompt customizable with -p option like command-prompt
  • and add the character pairs #W and #P to the default kill-{pane,window}
  • prompts.
  • Avoid sending data to suspended/locked clients.
  • Small memory leaks in error paths plugged.
  • Vi mode improvements.

New in tmux 1.4 (Dec 29, 2010)

  • Window bell reporting fixed.
  • Show which pane is active in the list-panes output.
  • Backoff reworked.
  • Prevent the server from dying when switching into copy mode when already
  • in a different mode.
  • Reset running jobs when the status line is enabled or disabled.
  • Simplify xterm modifier detection.
  • Avoid crashing in copy mode if the screen size is too small for the
  • indicator.
  • Flags -n and -p added to switch-client.
  • Use UTF-8 line drawing characters on UTF-8 terminals, thus fixing some
  • terminals (eg putty) which disable the vt100 ACS mode switching sequences
  • in UTF-8 mode. On terminals without ACS, use ASCII equivalents.
  • New server option exit-unattached added.
  • New session option destroy-unattached added.
  • Fall back on normal session choice method if $TMUX exists but is invalid
  • rather than rejecting.
  • Mark repeating keys with "(repeat)" in the key list.
  • When removing a pane, don't change the active pane unless the active pane
  • is actually the one being removed.
  • New command last-pane added.
  • AIX fixes.
  • Flag -a added to unbind-key.
  • Add XAUTHORITY to update-environment.
  • More info regarding window and pane flags is now shown in list-*.
  • If VISUAL or EDITOR contains "vi" configure mode-keys and status-key to vi.
  • New window option monitor-silence and session option visual-silence added.
  • In the built-in layouts distribute the panes more evenly.
  • Set the default value of main-pane-width to 80 instead of 81.
  • Command-line flag -V added.
  • Instead of keeping a per-client prompt history make it global.
  • Fix rectangle copy to behave like emacs (the cursor is not part of the
  • selection on the right edge but on the left it is).
  • Flag -l added to switch-client.
  • Retrieve environment variables from the global environment rather than
  • getenv(3), thus allowing them to be updated during the configuration file.
  • New window options other-pane-{height,width} added.
  • More minor bugs fixed and manpage improvements.

New in tmux 1.3 (Jul 19, 2010)

  • New input parser.
  • Flags to move through panes -UDLR added to select-pane.
  • Commands up-pane, and down-pane removed, since equivalent behaviour is now
  • available through the target flag (-t:+ and -t:-).
  • Jump-forward/backward in copy move (based on vi's F, and f commands).
  • Make paste-buffer accept a pane as a target.
  • Flag -a added to new-window to insert a window after an existing one, moving
  • windows up if necessary.
  • Merge more mode into copy mode.
  • Run job commands explicitly in the global environment (which can be modified
  • with setenv -g), rather than with the environment tmux started with.
  • Use the machine's hostname as the default title, instead of an empty string.
  • Prevent double free if the window option remain-on-exit is set.
  • Key string conversions rewritten.
  • Mark zombie windows as dead in the choose-window list.
  • Tiled layout added.
  • Signal handling reworked.
  • Reset SIGCHLD after fork to fix problems with some shells.
  • Select-prompt command removed. Therefore, bound ' to command-prompt -p index
  • "select-window -t:%%" by default.
  • Catch SIGHUP and terminate if running as a client, thus avoiding clients from
  • being left hanging around when, for instance, a SSH session is disconnected.
  • Solaris 9 fixes (such as adding compat {get,set}env(3) code).
  • Accept none instead of default for attributes.
  • Window options window-status-alert-{alert,bg,fg} added.
  • Flag -s added to the paste-buffer command to specify a custom separator.
  • Allow dragging to make a selection in copy mode if the mode-mouse option is
  • set.
  • Support the mouse scroll wheel.
  • Make pipe-pane accept special character sequences (eg #I).
  • Fix problems with window sizing when starting tmux from .xinitrc.
  • Give tmux sockets (but not the containing folder) group permissions.
  • Extend the target flags (ie -t) to accept an offset (for example -t:+2), and
  • make it wrap windows, and panes.
  • New command choose-buffer added.
  • New server option detach-on-destroy to set what happens to a client when the
  • session it is attached to is destroyed. If on (default), the client is
  • detached. Otherwise, the client is switched to the most recently active of
  • the remaining sessions.
  • The commands load-buffer, and save-buffer now accept a dash (-) as the file
  • to read from stdin, or write to stdout.
  • Custom layouts added.
  • Additional code reduction, bug fixes, and manpage enhancements.

New in tmux 1.2 (Mar 11, 2010)

  • Switch to libevent.
  • Emulate the ri (reverse index) capability, ergo allowing tmux to at least
  • start on Sun consoles (TERM=sun, or sun-color).
  • Assign each entry a number, or lowercase letter in choose mode, and accept
  • that as a shortcut key.
  • Permit top-bit-set characters to be entered in the status line.
  • Mark no-prefix keys with (no prefix), rather than [] in list-keys.
  • New command show-messages (alias showmsgs), and new session option
  • message-limit, to show a per-client log of status lines messages up to the
  • number defined by message-limit.
  • Do not interpret #() for display-message to avoid leaking commands.
  • New window options window-status-format, and window-status-current-format to
  • control the format of each window in the status line.
  • Add a -p flag to display-message to print the output, instead of displaying
  • it in the status line.
  • Emulate il1, dl1, ich1 to run with vt100 feature set.
  • New command capture-pane (alias capturep) to copy the entire pane contents
  • to a paste buffer.
  • Avoid duplicating code by adding a -w flag to set-option, and show-options to
  • set, and show window options. The commands set-window-option, and
  • show-window-options are now aliases.
  • Panes can now be referred to as top, bottom, top-left, etc.
  • Add server-wide options, which can be set with set-option -s, and shown with
  • show-options -s.
  • New server option quiet (like -q from the command line).
  • New server option escape-time to set the timeout used to detect if escapes
  • are alone, part of a function key, or meta sequence.
  • New session options pane-active-border-bg, pane-active-border-fg,
  • pane-border-bg, and pane-border-fg to set pane colours.
  • Make split-window accept a pane target, instead of a window.
  • New command join-pane (alias joinp) to split, and move an existing pane into
  • the space (the opposite of break-pane), thus simplifying calls to
  • split-window, followed by move-window.
  • Permit S- prefix on keys for shift when the terminal/terminfo supports them.
  • Window targets (-t flag) can now refer to the last window (!), next (+), and
  • previous (-) window by number.
  • Mode keys to jump to the bottom/top of history, end of the next word, scroll
  • up/down, and reverse search in copy mode.
  • New session option display-panes-active-colour to display the active pane in
  • a different colour with the display-panes command.
  • Read the socket path from $TMUX if it's present, and -L, and -S are not
  • given.
  • Vi-style mode keys B, W, and E to navigate between words in copy mode.
  • Start in more mode when configuration file errors are detected.
  • Rectangle copy support added.
  • If attach-session was specified with the -r flag, make the client read-only.
  • Per-window alternate-screen option.
  • Make load-buffer work with FIFOs.
  • New window option word-separators to set the characters considered as word
  • separators in copy mode.
  • Permit keys in copy mode to be prefixed by a repeat count, entered with [1-9]
  • in vi mode, or M-[1-9] in emacs mode.
  • utf8 improvements.
  • As usual, additional code reduction, bug fixes, and manpage enhancements.

New in tmux 0.8 (Apr 23, 2009)

  • basic horizontal window splitting and automatic pane layout;
  • improved UTF-8 support and reduced memory consumption;
  • support for 88 colour terminals;
  • emulation of scroll region for terminals without it;
  • several new commands and a few bug fixes.

New in tmux 0.7 (Feb 10, 2009)

  • copy-buffer and suspend-client commands;
  • support for placing the output of a command in the status line;
  • individual window colours in status line;
  • better mouse support;
  • can now set attributes for status line etc;
  • better support for black and white terminals;
  • automatically rename window to match command running in it;
  • ability to specify multiple commands as a sequence.

New in tmux 0.6 (Jan 19, 2009)

  • Special substitutions in status-left/right (#T for window title, #S for session name, #H for hostname).
  • Interactive window and session choice screens (bound to "w" and "s" by default).
  • Repetition of some commands if pressed repeatedly without necessity to press prefix key again.
  • Vertical window splitting. YAY!
  • Server locking (lock-server command) and automatic locking on inactivity (lock-after-time option).
  • command-prompt command option to accept an argument used to construct the command, and this is used for interactive window rename bound to "," key.
  • save-buffer command.
  • source-file command to load a configuration file interactively or from .tmux.conf.
  • server-info command to show some detailed info, largely for debugging.
  • Some reduction in reliance on the ncurses mess.
  • Better key handling, including support for generating xterm-style function key output.
  • Flag to unset an option.
  • Global window options.
  • Global options are now set with a -g flag leaving it out sets current window/session only.
  • Better completion plus command history in command prompt.
  • Home and End keys should now work.
  • vim mode for tmux configuration.
  • Unbreak getopt on Linux.
  • Options to control the maximum length of status-left/right.

New in tmux 0.5 (Nov 20, 2008)

  • New window option: "utf8"; this must be on (it is off by default) for UTF-8 to be parsed. The global/session option "utf8-default" controls the setting for new windows.
  • This means that by default tmux does not handle UTF-8. To use UTF-8 by default it is necessary to a) "set utf8-default on" in .tmux.conf b) start tmux with -u on any terminal which support UTF-8.
  • It seems a bit unnecessary for this to be a per-window option but that is the easiest way to do it, and it can't do any harm...
  • Enable default colours if op contains 33[39;49m, based on a report from fulvio ciriaco.

New in tmux 0.4 (Oct 2, 2008)

  • support for windows remaining open after process inside dies;
  • a command prompt and window index prompt;
  • ability to bind alt (meta) keys;
  • nextand previous-word keys in copy-mode;
  • set window titles in xterm;
  • revamped paste buffer system;
  • scroll status line to show current window;
  • some bug fixes and minor feature additions.