1DMENU(1) General Commands Manual DMENU(1)
2
3
4
6 dmenu - dynamic menu
7
9 dmenu [-i] [-b] [-fn <font>] [-nb <color>] [-nf <color>] [-p <prompt>]
10 [-sb <color>] [-sf <color>] [-v]
11
13 Overview
14 dmenu is a generic menu for X, originally designed for dwm(1). It man‐
15 ages huge amounts (up to 10.000 and more) of user defined menu items
16 efficiently.
17
18 Options
19 -i makes dmenu match menu entries case insensitively.
20
21 -b defines that dmenu appears at the bottom.
22
23 -fn <font>
24 defines the font.
25
26 -nb <color>
27 defines the normal background color (#RGB, #RRGGBB, and color
28 names are supported).
29
30 -nf <color>
31 defines the normal foreground color (#RGB, #RRGGBB, and color
32 names are supported).
33
34 -p <prompt>
35 defines a prompt to be displayed before the input area.
36
37 -sb <color>
38 defines the selected background color (#RGB, #RRGGBB, and color
39 names are supported).
40
41 -sf <color>
42 defines the selected foreground color (#RGB, #RRGGBB, and color
43 names are supported).
44
45 -v prints version information to standard output, then exits.
46
48 dmenu reads a list of newline-separated items from standard input and
49 creates a menu. When the user selects an item or enters any text and
50 presses Return, his/her choice is printed to standard output and dmenu
51 terminates.
52
53 dmenu is completely controlled by the keyboard. The following keys are
54 recognized:
55
56 Any printable character
57 Appends the character to the text in the input field. This
58 works as a filter: only items containing this text will be dis‐
59 played.
60
61 Left/Right (Mod1-h/Mod1-l)
62 Select the previous/next item.
63
64 PageUp/PageDown (Mod1-k/Mod1-j)
65 Select the first item of the previous/next 'page' of items.
66
67 Home/End (Mod1-g/Mod1-G)
68 Select the first/last item.
69
70 Tab (Control-i)
71 Copy the selected item to the input field.
72
73 Return (Control-j)
74 Confirm selection and quit (print the selected item to standard
75 output). Returns 0 on termination.
76
77 Shift-Return (Control-Shift-j)
78 Confirm selection and quit (print the text in the input field to
79 standard output). Returns 0 on termination.
80
81 Escape (Control-bracketleft)
82 Quit without selecting an item. Returns 1 on termination.
83
84 Backspace (Control-h)
85 Remove a character from the input field.
86
87 Control-u
88 Remove all characters from the input field.
89
90 Control-w
91 Remove all characters of current word from the input field.
92
94 dwm(1), wmii(1).
95
96
97
98 dmenu-4.0 DMENU(1)