1DMENU(1)                    General Commands Manual                   DMENU(1)
2
3
4

NAME

6       dmenu - dynamic menu
7

SYNOPSIS

9       dmenu  [-i] [-b] [-fn <font>] [-nb <color>] [-nf <color>] [-p <prompt>]
10       [-sb <color>] [-sf <color>] [-v]
11

DESCRIPTION

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

USAGE

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

SEE ALSO

94       dwm(1), wmii(1).
95
96
97
98                                   dmenu-4.0                          DMENU(1)
Impressum