Skip to content

Install

Requirements

  • tmux 3.2 or newer
  • Prebuilt binaries: Linux or macOS on x86_64 or ARM64
  • Install script: curl, tar, and either sha256sum or shasum
  • Cargo or source: Rust 1.85 or newer

Install script

sh
curl -fsSL https://raw.githubusercontent.com/phcurado/tpane/main/install.sh | sh

The script installs to ~/.local/bin. Set BIN_DIR to change it. The directory must be on PATH.

crates.io

sh
cargo install tpane

mise

sh
mise use -g github:phcurado/tpane@latest

Update with:

sh
mise upgrade github:phcurado/tpane

Source

From the repo root:

sh
cargo install --path . --locked --force

Check the installed version:

sh
tpane --version

Uninstall

Remove run-shell -b 'tpane' from your tmux config first. See Roll back for an existing tmux server.

Then remove the binary using the same installation method:

sh
rm ~/.local/bin/tpane                          # install script
cargo uninstall tpane                          # crates.io or source
mise unuse -g github:phcurado/tpane            # mise

Your Lua configuration is left in ~/.config/tmux/tpane. Git plugins are left in $XDG_DATA_HOME/tpane or ~/.local/share/tpane; remove them separately if you no longer need them.