DMENU(1) (dmenu-VERSION) DMENU(1)
NAME
dmenu - dynamic menu
SYNOPSIS
dmenu [-i] [-b] [-l <lines>] [-fn <font>] [-nb <color>] [-nf
<color>] [-p <prompt>] [-sb <color>] [-sf <color>] [-v]
DESCRIPTION
Overview
dmenu is a generic menu for X, originally designed for
dwm(1). It manages huge amounts (up to 10.000 and more) of
user defined menu items efficiently.
Options
-i makes dmenu match menu entries case insensitively.
-b defines that dmenu appears at the bottom.
-l <lines>
activates vertical list mode. The given number of
lines will be displayed. Window height will get
adjusted.
-fn <font>
defines the font.
-nb <color>
defines the normal background color (#RGB, #RRGGBB, and
color names are supported).
-nf <color>
defines the normal foreground color (#RGB, #RRGGBB, and
color names are supported).
-p <prompt>
defines a prompt to be displayed before the input area.
-sb <color>
defines the selected background color (#RGB, #RRGGBB,
and color names are supported).
-sf <color>
defines the selected foreground color (#RGB, #RRGGBB,
and color names are supported).
-v prints version information to standard output, then
exits.
USAGE
dmenu reads a list of newline-separated items from standard
Page 1 Plan 9 (printed 3/11/10)
DMENU(1) (dmenu-VERSION) DMENU(1)
input and creates a menu. When the user selects an item or
enters any text and presses Return, his/her choice is
printed to standard output and dmenu terminates.
dmenu is completely controlled by the keyboard. The follow-
ing keys are recognized:
Any printable character
Appends the character to the text in the input field.
This works as a filter: only items containing this text
will be displayed.
Left/Right (Up/Down) (Mod1-h/Mod1-l)
Select the previous/next item.
PageUp/PageDown (Mod1-k/Mod1-j)
Select the first item of the previous/next 'page' of
items.
Home/End (Mod1-g/Mod1-G)
Select the first/last item.
Tab (Control-i)
Copy the selected item to the input field.
Return (Control-j)
Confirm selection and quit (print the selected item to
standard output). Returns 0 on termination.
Shift-Return (Control-Shift-j)
Confirm selection and quit (print the text in the input
field to standard output). Returns 0 on termination.
Escape (Control-bracketleft)
Quit without selecting an item. Returns 1 on termina-
tion.
Backspace (Control-h)
Remove a character from the input field.
Control-u
Remove all characters from the input field.
Control-w
Remove all characters of current word from the input
field.
SEE ALSO
dwm(1), wmii(1).
Page 2 Plan 9 (printed 3/11/10)