• v2.0.0 e90e1e50da

    v2.0.0 Stable

    zdykstra released this 2026-11-16 20:50:18 -06:00 | 0 commits to master since this release

    tmuxc changes since v1.9.1

    Breaking changes

    • exitlast is now on by default. --noexitlast turns it off.
    • Pause is gone: the -p/--pause option, the PauseSelf command and menu entry, and extras/xscreensaver-watcher.sh have been removed.
    • tmuxc now uses the first config file it finds. The search order is ~/.config/tmuxc.conf, ~/.tmuxc.conf, ~/.config/tmuxc/tmuxc.conf, then the Haiku settings file. $XDG_CONFIG_HOME/tmuxc.settings is no longer searched.
    • @ and : in session names are replaced with -, as . already was. The remote session menu hides sessions whose names contain ., : or @.
    • The command FIFO is read directly, so tmuxc no longer waits for USR1. USR1 is accepted and ignored.
    • An invalid command-line option now prints usage and exits with status 2.

    New

    • Terminal hook: the hook_sub option names a Perl file that returns a code ref, and the hook option is a hash set globally, per host or per session. The sub runs before each terminal opens and can add arguments to the terminal command.
    • KWin hook: kwin.pl places each terminal window. It can put the window on a desktop, maximize it, tile it to a half or quarter of the screen, or center it.
    • ssh_control sets the name of the ControlMaster socket. The default is %C.
    • blacklist and ssh_prereqs can be set globally, per host or per session, and inherit from the level above with @inherit%parent%.
    • Each attached session gets an @tmuxc_wm tag set to its window mode, so key bindings and the status bar can depend on the mode.
    • on_connect now also runs in multi-window mode, once for each clone session.
    • --print output is grouped, aligned and colored. NO_COLOR turns the color off.

    Reconnect and reliability

    • Failed attaches now back off the same way failed connections do, up to 64 seconds. tmuxc logs why the control session ended.
    • ssh_prereqs run before every ControlMaster attempt and retry every prereq_interval seconds (default 1) instead of using the backoff. A failing prereq no longer exits tmuxc while reconnect is on.
    • reconnect is now respected when exitlast is set.
    • exitlast now works for local sessions.
    • A config reload that fails now keeps the running config. Before, it killed the daemon.
    • The command FIFO is set up before the first connection, so tmuxc -e works while tmuxc is still trying to connect.
    • The pidfile is now held with flock. This stops two copies of the same session starting at once and stops a reused PID making a dead instance look alive.

    Fixes

    • Session names, host names and window names containing spaces, quotes, commas, colons or shell metacharacters now work. tmuxc quotes them, runs its commands without a local shell, and matches tmux session targets exactly.
    • Clone sessions are created from the control session, so they always join the right group. Each clone gets destroy-unattached set on it correctly.
    • tmuxc only picks up its own clones. Before, a host named box also claimed clones made by box2.
    • Remote session names no longer end in a stray \r.
    • Option arrays set at host level are no longer listed as sessions.
    • Syslog messages are logged at their own level, and nothing goes to syslog unless log_facility is set. Errors are logged at LOG_ERR.
    • closeas now ignores windows whose terminal was closed.
    • Forked terminal children exit with POSIX::_exit. A failed exec no longer runs the daemon's cleanup.
    • The broken tmux version check and RefreshClient have been removed.
    • The script finds perl through /usr/bin/env.

    Docs

    • The README, POD and man page now describe wm and poe as tmuxc actually reads them, and correct skipnw, the ssh_prereqs exit behavior and the config search order.
    • They also cover the terminal hook and the @tmuxc_wm bindings.
    • The example config is a working config that uses the KWin hook.
    Downloads