TmuxPlus

Visual TUI manager for tmux, built with Textual and libtmux.

Leia em Português

Features

• Full management of tmux sessions, windows, and panes
• Save and restore session layouts (JSON persistence)
• Command palette (Ctrl+P) for quick access
• Switchable themes (Ctrl+T) — Dracula, Monokai, Gruvbox, Nord, Tokyo Night and more
• Portuguese (pt-BR) interface with internationalization support
• Auto-reconnect — after detaching (Ctrl+B, D), TmuxPlus reopens automatically

Installation

Quick

bash install.sh

Manual

git clone https://github.com/megamvb/TmuxPlus.git
cd TmuxPlus
pip install -r requirements.txt
python3 main.py

Dependencies

• Python 3.10+
• tmux
• textual >= 0.50.0
• libtmux >= 0.25.0

Usage

python3 main.py          # start
python3 main.py --log    # start with file logging

Key Bindings

Global

Key	Action
Ctrl+Q	Quit
Ctrl+T	Toggle theme
?	Help
Ctrl+P	Command palette

Home Screen

Key	Action
1	Sessions
2	Windows
3	Panes
q	Quit

Sessions Screen

Key	Action
c	Create session
r	Rename session
a	Attach to session
k	Kill session
s	Save session to disk
l	Load saved session
F5	Refresh list
Escape	Back

Windows Screen

Key	Action
c	Create window
r	Rename window
s	Select window
k	Close window
F5	Refresh list
Escape	Back

Panes Screen

Key	Action
v	Split vertically
h	Split horizontally
x	Send command to pane
H	History picker
A	Alias picker
k	Close pane
F5	Refresh list
Escape	Back

Tmux Popup (inside terminal)

Key	Action
Ctrl+B H	History picker (filterable popup)
Ctrl+B A	Alias picker (filterable popup)

Project Structure

TmuxPlus/
├── main.py                # Entry point — attach/detach loop
├── app.py                 # Textual App, command palette, themes
├── screens/               # Screens (Home, Sessions, Windows, Panes, Help)
├── services/              # TmuxService — tmux operations via libtmux
├── widgets/               # Custom widgets
├── styles/app.tcss        # Textual CSS
├── i18n/                  # Internationalization
├── install.sh             # Install script
└── requirements.txt

License

MIT