A small tmux toolkit
Tools up.
Context stays.
A quick menu for your tmux tools. Open a shell, jot a note, start a timer. One TSV registry generates the menu and your direct bindings.
Bash + tmux. MIT licensed. Your terminal keeps its font and theme.
Shell, in the invoking directory.
Open a shell over your pane. The default shell popup is 75% wide and 75% high.
Direct binding: Prefix + TBrowser illustration Five default entries. In tmux, open the menu with Prefix + Enter.
One place to edit
Add a row.
Get a popup.
The menu and direct shortcuts come from the same rows. Give a tool a name, keys, dimensions and a command; the launcher handles the rest.
shell T Enter shell 75% 75% -
Keep your changes in ~/.config/tmux-popups/popups.local.tsv. A matching ID overrides the shipped row; a new ID adds an entry. Plugin updates leave that file alone.
Small by default
Start with five.
Make it yours.
- On at first load
- Help, shell, daily notes, timer and tmux keys.
Prefix + Enteropens the quick menu. - 25 shipped entries
- Optional adapters include lazygit, Yazi, logs, a calculator and more. Enable the ones you use and install their dependencies.
- Your own tools
- Add local scripts with literal JSON arguments. Choose popup, window or command mode. Reuse a tool window when you opt in.
- Check before you launch
- Help and the CLI show dependency status. Doctor checks the configuration. Existing prefix bindings are skipped by default.
Session switching stays with tools such as tmux-sessionx. Optional adapters need their own app configuration; a dependency check doesn’t validate accounts or credentials.
Get the toolkit
One line
in your config.
Add this to your tmux configuration with TPM, alongside your other plugins:
set -g @plugin 'PatrickFanella/tmux-popups'
Reload your tmux config, then press Prefix + I to install. Press Prefix + Enter to open the menu. Prefix means your configured tmux prefix, commonly Ctrl + b.
Installs from source. No tagged release is published yet. The launcher uses Bash and tmux; some optional helpers need Python 3 or other tools.
Manual install, requirements and first runFrom SUBCULT
Keep small tools moving.
SUBCULT builds tmux-popups and other public tools. If you’d like to support the work, contributions go to the studio.
Need help with the toolkit? Open an issue or start with troubleshooting.