Skip to main content
Back to Commands
MiscellaneousN/A (bind to a key)

display-menu

Short form: menu

Display an interactive menu at the given position. Each item has a display name, a shortcut key, and a tmux command to run when chosen.

Synopsis

bash
tmux display-menu [-OM] [-b border-lines] [-c target-client] [-C starting-choice] [-H selected-style] [-s style] [-S border-style] [-t target-pane] [-T title] [-x position] [-y position] name key command [name key command ...]

Options

FlagDescription
-T titleMenu title
-x positionHorizontal position (number, or R/P/M)
-y positionVertical position
-MAlways enable the mouse while the menu is open
-ODon't close automatically when the mouse is released

Examples

Show a small window menu at the pane

bash
tmux display-menu -T "Window" -x P -y P "New" c new-window "Kill" x kill-window

Bind a quick split menu

bash
bind m display-menu "Split -h" h "split-window -h" "Split -v" v "split-window -v"

Default Keybinding

N/A (bind to a key)

Default prefix is Ctrl+b

Pro Tips

  • An empty item name inserts a separator line
  • Position with -x/-y using a number or R/P/M (right, pane, mouse)