tmuxp is an active and frequently updated Python session manager for tmux, enabling users to save, load, and manage complex tmux sessions and workspaces via simple YAML or JSON configuration files. It is built upon the `libtmux` Python API for programmatic interaction with tmux.
pip install tmuxpVerified import paths — ran on the pinned version, not inferred.
Create a YAML configuration file to define a tmux session, then load it using the `tmuxp load` CLI command. Configuration files are typically stored in `~/.tmuxp/` or within project directories (e.g., `.tmuxp.yaml`).
Upgrade your Python environment to 3.10 or newer.
Run `pip install --upgrade libtmux` or update your `libtmux` dependency specification.
Adjust scripts to account for the new spinner output, or disable it using `--no-progress`. You can also customize the spinner with `--progress-format` and `--progress-lines`.
For detailed debugging output, add `--log-level debug` to your `tmuxp` command.
Upgrade your tmux installation to version 3.2a or newer. You can suppress the warning by setting the `LIBTMUX_SUPPRESS_VERSION_WARNING=1` environment variable.
Upgrade tmuxp to version 1.17.2 or newer, which fixed the issue. Alternatively, load each session individually or specify a directory containing multiple `.tmuxp.yaml` files.
Ensure `tmuxp` is installed correctly for your user (e.g., `pip install --user tmuxp`) and that your PATH is configured to find user-installed scripts. Avoid using `sudo` with `pip install --user`.
Check your system's Python setup (`which python`, `which pip`), ensure correct virtual environment activation within `tmuxp` configs, and verify shell command execution outside `tmuxp`. Use `tmuxp debug-info` for system details.
Upgrade `libtmux` to version 0.53.0 or newer. This fix was included in `tmuxp` v1.62.0.