• 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
  • v1.9.1 2cebe0c942

    zdykstra released this 2023-09-29 09:25:20 -05:00 | 52 commits to master since this release

    Perl 5.38.0 changed the default behavior of readline(). A single command could be sent to the control FIFO, all additional commands would not be read out and would be no-ops.

    Downloads
  • v1.9 2291cd39fa

    zdykstra released this 2022-12-01 15:59:53 -06:00 | 55 commits to master since this release

    It's been a while since the last release, and a few minor improvements and changes have accumulated.

    Breaking changes

    The options --swm and --mwm have been moved to the --wm flag. Possible values are single or multi.

    New features

    First time contributor @ClashTheBunny provided the ssh_prereqs configuration option. Commands defined here are executed on the local host prior to attempting to start a ControlMaster session to the remote machine. If any of the commands exit with a status of 1, tmuxc exits. Thank you!

    TMUX_SESSION_NAME is defined before starting tmux, so that it's available as an environment variable inside sessions.

    All commits

    • 2291cd3 - perltidy, bump to v1.9 (Zach Dykstra)
    • 0545138 - Add ability to add a command as a prerequisite for SSH (Randall Mason)
    • ba99c1b - Fix usage of single|multi (Zach Dykstra)
    • 9c734e2 - Add csv header to document each field (Zach Dykstra)
    • 6cfde25 - Clean tmux session names from all sources (Zach Dykstra)
    • fcb4ede - Move mwm/swm to a single multi-opt CLI flag (Zach Dykstra)
    • 8bb609d - Correctly reap child processes instead of zombifying them (Zach Dykstra)
    • aa30037 - '.' is invalid in tmux session names (Zach Dykstra)
    • 2f76ddc - Only do swm if mwm is not explicitly enabled on the CLI (Zach Dykstra)
    • fdfd889 - Reap zombie SSH processes when a ControlMaster session dies (Zach Dykstra)
    • 5bbcb31 - Set it when attaching a terminal to a session (Zach Dykstra)
    • f0cd34c - Set TMUX_SESSION_NAME when creating sessions via SSH (Zach Dykstra)
    Downloads
  • v1.8 a8559cd4d4

    zdykstra released this 2021-02-11 14:04:55 -06:00 | 67 commits to master since this release

    This release has been a long time coming! Significant commits:

    • d0a7296 - Quality of life fixes for Haiku (Zach Dykstra)
    • e111e61 - Add exponential backoff for failed remote connection (Zach Dykstra)
    • 6a2a4b8 - Ephemeral / remote session handling cleaning (Zach Dykstra)
    • 991a302 - Single/Multi window launcher shortcuts (Zach Dykstra)
    • 7e9ec09 - Logging fixes, reconnection fix (Zach Dykstra)
    • 0c1e13d - Add man page (Zach Dykstra)
    • 6157bab - Add remote host session picker (Zach Dykstra)
    • dc9a3b3 - Expose LoadConfig via options menu (Zach Dykstra)
    Downloads
  • v1.7.1 3a4290cfe0

    zdykstra released this 2020-07-09 17:20:42 -05:00 | 86 commits to master since this release

    This is a point-release fix for incorrect logic that slipped through last night. exitlast should now do the correct thing when enabled and the right conditions are met.

    Downloads
  • v1.7 cb97a61f51

    zdykstra released this 2020-07-08 22:56:21 -05:00 | 87 commits to master since this release

    This release rolls up a pair of small fixes accumulated over the last few months. Notably, --exitlast|E now correctly exits when a tmux session ends. This means that when you exit the last shell in an ephemeral session, tmuxc now exits instead of spawning the session again.

    5218149 - Correctly handle tmux sessions closing (Zach Dykstra)
    e9ad2c4 - Add debug output for control mode attach command (Zach Dykstra)
    1880a96 - Kill child processes when going through the main loop again (Zach Dykstra)

    Downloads
  • v1.6 3141e3cedd

    zdykstra released this 2020-04-06 14:46:12 -05:00 | 91 commits to master since this release

    Included in this release is the --poe|P option. This option, when enabled, can be used to automatically clean up a session on tmuxc exit.

    • --poe none: no action taken
    • --poe ephemeral: if the session is marked as ephemeral, it will be removed via kill-session on tmuxc exit
    • --poe any: regardless of the session type, it is removed on tmuxc exit. Use this option cautiously!
    Downloads
  • v1.5 40e34ee270

    zdykstra released this 2020-02-27 21:20:09 -06:00 | 96 commits to master since this release

    • SSH speed improvements
      Instead of executing a series of commands over an SSH session, one-by-one, the startup process is now written to a shell script and executed via /bin/sh on the remote host. This step helps improve startup time for remote sessions over a high latency link.
      Additionally, instead of executing a few commands over SSH, they're instead executed through the tmux control mode socket which avoids the setup/teardown time involved with SSH.

    • Single Window Mode
      Some times, a session is still best served as a single window. tmuxc now supports this behavior via the swm option in the configuration file, or via -w on the command line. Refer to the updated documentation for additional configuration file options usable in single window mode - specifically on_connect. The launched terminal is tied to the life of tmuxc - if tmuxc exits, the terminal is reclaimed.

    • CLI usability

      • When tmuxc is invoked without any arguments, the --help output is displayed.
      • Sessions on the CLI can now be defined as session@hostname, to match the pretty process entry.
      • With out any flags, a full session can be launched - tmuxc session@hostname will start that session for you.
    • Cloned session names
      Previously, cloned sessions were composed of a number of different unique elements separated by a series of dashes. This lead to difficulties parsing the cloned session name if a hostname or a session name had a dash in it. Instead, sessions are now composed of a few unique elements separated by slashes.

      • In multi-window mode, cloned session names take the format tmuxc/hostname/session/window id (tmuxc/meluan/global-session/11)
      • In single-window mode, cloned session names take the format tmuxc/hostname/session (tmuxc/meluan/global-session)
      • Control sessions are now created once per tmux session, and shared between clients. They take the format tmuxc/session/control (tmuxc/global-session/control).
    • Internal changes
      The options/flags killrc and pauserc have been removed, as they only worked under a very specific set of circumstances. I will be re-implementing them to be more functional under a variety of situations.

    Downloads
  • v1.3.5 59e59496ab

    zdykstra released this 2020-01-20 16:56:27 -06:00 | 106 commits to master since this release

    This release adds a few cosmetic changes.

    • The configuration option prettyps is enabled by default, which renames a running tmuxc process to be the name of the script, with the session@host. Entries in the process table will now look like tmuxc global-session@localhost.
    • A number of tmux command line argument changes were enacted, to further shrink the length of the command that is executed. All of the required options are either set now when a session group is cloned, or after a client has attached to a session. An attached tmux client will now look like tmux attach -t meluan-global-session-1579560844-178905-21 in your process table.
    • As part of the tmux command line golfing process, commands can now be injected into a tmuxc socket when a client first connects to a session. Right now, destroy-unattached on is sent, but additional commands on connect can be added through this mechanism.
    • Ephemeral sessions (those without a respective .tmuxc.conf entry) are now properly tracked and noted in the --known output. These sessions will have (ephemeral) noted after the session@host line.
    • Fix actions taken on tmux major version 3. With the release of tmux 3.0a the major/minor had to be split apart so an integer comparison can be done on the major version. The refresh-client code path now executes again.
    Downloads
  • v1.3.0 a80e7f2be3

    zdykstra released this 2019-12-17 09:22:43 -06:00 | 112 commits to master since this release

    Interaction improvements!

    • Adds support for a single page menu, combining all known sessions and the actions that can be done for each session into one menu.
    • Add a pause toggle to the menu system
    • Support looking for a configuration file at ~/.tmuxc.conf ~/.config/tmuxc.conf and ~/.config/tmuxc/tmuxc.conf
    • Restore skipnw to the options parser, so that value is actually respected in configuration files.
    • Rewrite options handling so the last 'action' option on the command line is what is executed.
    Downloads