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

NAME

6       dmenu - dynamic menu
7

SYNOPSIS

9       dmenu  [-bfiv]  [-l  lines]  [-m  monitor]  [-p prompt] [-fn font] [-nb
10       color] [-nf color] [-sb color] [-sf color] [-w windowid]
11
12       dmenu_run ...
13

DESCRIPTION

15       dmenu is a dynamic menu for X, which reads a list of  newline-separated
16       items  from  stdin.   When the user selects an item and presses Return,
17       their choice is printed to stdout and dmenu terminates.  Entering  text
18       will narrow the items to those matching the tokens in the input.
19
20       dmenu_run is a script used by dwm(1) which lists programs in the user's
21       $PATH and runs the result in their $SHELL.
22

OPTIONS

24       -b     dmenu appears at the bottom of the screen.
25
26       -f     dmenu grabs the keyboard before reading  stdin  if  not  reading
27              from  a  tty.  This  is  faster,  but will lock up X until stdin
28              reaches end-of-file.
29
30       -i     dmenu matches menu items case insensitively.
31
32       -l lines
33              dmenu lists items vertically, with the given number of lines.
34
35       -m monitor
36              dmenu is displayed on the monitor number supplied. Monitor  num‐
37              bers are starting from 0.
38
39       -p prompt
40              defines  the  prompt  to  be  displayed to the left of the input
41              field.
42
43       -fn font
44              defines the font or font set used.
45
46       -nb color
47              defines the normal background color.  #RGB, #RRGGBB, and X color
48              names are supported.
49
50       -nf color
51              defines the normal foreground color.
52
53       -sb color
54              defines the selected background color.
55
56       -sf color
57              defines the selected foreground color.
58
59       -v     prints version information to stdout, then exits.
60
61       -w windowid
62              embed into windowid.
63

USAGE

65       dmenu is completely controlled by the keyboard.  Items are selected us‐
66       ing the arrow keys, page up, page down, home, and end.
67
68       Tab    Copy the selected item to the input field.
69
70       Return Confirm selection.  Prints the selected item to stdout  and  ex‐
71              its, returning success.
72
73       Ctrl-Return
74              Confirm  selection.  Prints the selected item to stdout and con‐
75              tinues.
76
77       Shift-Return
78              Confirm input.  Prints the input text to stdout and  exits,  re‐
79              turning success.
80
81       Escape Exit without selecting an item, returning failure.
82
83       Ctrl-Left
84              Move cursor to the start of the current word
85
86       Ctrl-Right
87              Move cursor to the end of the current word
88
89       C-a    Home
90
91       C-b    Left
92
93       C-c    Escape
94
95       C-d    Delete
96
97       C-e    End
98
99       C-f    Right
100
101       C-g    Escape
102
103       C-h    Backspace
104
105       C-i    Tab
106
107       C-j    Return
108
109       C-J    Shift-Return
110
111       C-k    Delete line right
112
113       C-m    Return
114
115       C-M    Shift-Return
116
117       C-n    Down
118
119       C-p    Up
120
121       C-u    Delete line left
122
123       C-w    Delete word left
124
125       C-y    Paste from primary X selection
126
127       C-Y    Paste from X clipboard
128
129       M-b    Move cursor to the start of the current word
130
131       M-f    Move cursor to the end of the current word
132
133       M-g    Home
134
135       M-G    End
136
137       M-h    Up
138
139       M-j    Page down
140
141       M-k    Page up
142
143       M-l    Down
144

SEE ALSO

146       dwm(1), stest(1)
147
148
149
150                                   dmenu-5.1                          DMENU(1)
Impressum