Tmux Session Manager

Installation

Zplugin

zplugin light "RobertAudi/tsm"

zplug

zplug "RobertAudi/tsm"

zgen

zgen load RobertAudi/tsm

Antigen

antigen bundle RobertAudi/tsm

As a plugin

$ source "tsm.plugin.zsh"

Manually

For a "stable" version:

• Put dist/bin/tsm in a directory in your $PATH
• Put dist/functions/_tsm in a directory in your $FPATH (optional)

For the latest version:

• Run make
• Put build/tsm in a directory in your $PATH
• Put share/zsh/_tsm in a directory in your $FPATH (optional)

Requirements

• tmux (Tested versions: 2.3)
• zsh (Tested versions: 5.2, 5.3)
• 256 colors support
• *nix (Tested OS: macOS Sierra 10.12)

Usage

$ tsm <command> [args...]

Configuration

• $TSM_HOME (default: $XDG_DATA_HOME/tsm)
• $TSM_SESSIONS_DIR (default: $TSM_HOME/sessions)
• $TSM_BACKUPS_DIR (default: $TSM_HOME/backups)
• $TSM_DEFAULT_SESSION_FILE (default: $TSM_HOME/default-session.txt)
• $TSM_BACKUPS_COUNT (default: 20)

Note: If $XDG_DATA_HOME is not set and the $TSM_HOME environment variable was not customized, $HOME/.local/share will be used as fallback.

Commands

• [x] list
• [x] show
• [x] save
• [x] restore
• [x] resume
• [x] quit
• [ ] backup
• [ ] cleanup
• [x] help
• [x] version
• [ ] edit
• [x] remove
• [x] copy
• [x] duplicate
• [x] rename
• [ ] migrate
• [ ] env

TODO

• [ ] Man pages
• [ ] Configuration file
• [x] ASCII Art logo

Credits

• tmux-session by Mislav Marohnić (@mislav) was used as a starting point for this project.
• Lots of inspiration from zplug.

License

MIT