A full-featured TUI plugin manager for tmux — the modern alternative to TPM.
Browse, install, remove, update, and theme your tmux — all from a beautiful terminal interface.

cargo install --path .  →  tppanel

TPM works, but it's a shell script with no UI, no search, no browsing. Tmux Plugin Panel gives you a complete graphical plugin manager — think "app store for tmux" — right inside your terminal:

• Browse a curated registry of 40+ plugins, sorted by category and stars
• Search GitHub for any tmux plugin in real-time
• One-key install/remove/update — no editing config files manually
• Theme gallery — preview and switch tmux themes instantly
• Settings editor — toggle tmux options (mouse, status bar, keybindings) without memorizing set -g syntax
• Auto-detection — finds tmux (and PSMux) installations, versions, and config files automatically
• Config management — creates, parses, and updates tmux.conf / psmux.conf for you
• Offline fallback — ships with an embedded plugin registry; works without internet

• Rust toolchain (1.70+): rustup.rs
• tmux installed on your system (or PSMux)
• git (for cloning plugins)

# Clone and build
git clone https://github.com/marlocarlo/Tmux-Plugin-Panel.git
cd Tmux-Plugin-Panel
cargo build --release

# Run it
./target/release/tppanel

Or install directly:

cargo install --path .
tppanel

1. Tmux Plugin Panel auto-detects your tmux installation and config file
2. If no tmux.conf exists, press c to create one
3. Browse plugins → press Enter to install
4. Press R to reload tmux with your new plugins

src/
├── main.rs      # Entry point, terminal setup, event loop
├── app.rs       # Application state machine (5 tabs, selections, data)
├── ui.rs        # TUI rendering with ratatui (dashboard + 4 tabs + overlays)
├── registry.rs  # Plugin registry — embedded + external sources, search/filter
├── plugins.rs   # Git-based install/remove/update engine
├── themes.rs    # Theme management (install, activate, switch)
├── config.rs    # tmux.conf / psmux.conf parser, editor & factory reset
├── detect.rs    # Auto-detection of tmux/PSMux binaries & configs
└── github.rs    # GitHub API client for search & repo info

Tmux Plugin Panel ships with a curated registry of popular tmux plugins covering:

• ⭐ Essential — TPM, tmux-sensible, tmux-256color
• 🎨 Themes — Catppuccin, Dracula, Nord, Tokyo Night, Rose Pine, and more
• 💾 Session — tmux-resurrect, tmux-continuum
• 🧭 Navigation — vim-tmux-navigator, tmux-fzf
• 📊 Status Bar — tmux-cpu, tmux-battery, tmux-net-speed
• 📋 Clipboard — tmux-yank
• 🔧 Utility — tmux-fingers, tmux-open, tmux-logging

The registry is fetched from GitHub on startup and cached locally. An embedded copy is compiled into the binary as a fallback.

You can extend the built-in registry by adding external sources (local JSON files or remote URLs). See REGISTRY_FORMAT.md for the full schema and setup instructions.

Registry sources are configured in ~/.config/tppanel/registry_sources.json.

• Rust — safe, fast, no runtime
• ratatui — modern terminal UI framework
• crossterm — cross-platform terminal manipulation
• tokio — async runtime for GitHub API calls
• reqwest — HTTP client

Tmux Plugin Panel uses the standard TPM plugin syntax in your tmux config:

# ~/.tmux.conf
set -g @plugin 'tmux-plugins/tmux-sensible'
set -g @plugin 'catppuccin/tmux'
set -g @plugin 'tmux-plugins/tmux-resurrect'

Plugins are installed to ~/.tmux/plugins/ by default.

MIT — see Cargo.toml.

Contributions welcome! Feel free to open issues or submit pull requests.

1. Fork the repo
2. Create a feature branch
3. Make your changes
4. Submit a PR

Built with 🦀 Rust and ❤️ for the terminal