MiscellaneousPrefix + : display-popup (or bind a key)
display-popup
Short form: popup
Open a temporary popup terminal floating above the current client, running a command (a shell by default). Great for quick tools without disturbing your layout.
Synopsis
bash
tmux display-popup [-BCEkN] [-b border-lines] [-c target-client] [-d start-directory] [-e environment] [-h height] [-s style] [-S border-style] [-t target-pane] [-T title] [-w width] [-x position] [-y position] [shell-command [argument ...]]Options
| Flag | Description |
|---|---|
| -E | Close the popup when the command exits; -EE closes it only if the command succeeded |
| -B | Open without a border |
| -w width | Popup width (cells or percentage) |
| -h height | Popup height (cells or percentage) |
| -x position | Horizontal position |
| -y position | Vertical position |
| -T title | Set the popup title |
| -d start-directory | Working directory for the command |
Examples
Open a popup shell
bash
tmux display-popupRun htop in a popup, close on exit
bash
tmux display-popup -E htopBind Prefix + g to a lazygit popup
bash
bind g display-popup -E -w 80% -h 80% 'lazygit'Default Keybinding
Prefix + : display-popup (or bind a key)
Default prefix is Ctrl+b
Pro Tips
- •Use -E so the popup closes automatically when the command finishes
- •Perfect for lazygit, a scratch shell, notes, or a calculator