dmenu.1 - dmenu - dynamic menu
HTML git clone git://git.suckless.org/dmenu
DIR Log
DIR Files
DIR Refs
DIR README
DIR LICENSE
---
dmenu.1 (3356B)
---
1 .TH DMENU 1 dmenu\-VERSION
2 .SH NAME
3 dmenu \- dynamic menu
4 .SH SYNOPSIS
5 .B dmenu
6 .RB [ \-bfiv ]
7 .RB [ \-l
8 .IR lines ]
9 .RB [ \-m
10 .IR monitor ]
11 .RB [ \-p
12 .IR prompt ]
13 .RB [ \-fn
14 .IR font ]
15 .RB [ \-nb
16 .IR color ]
17 .RB [ \-nf
18 .IR color ]
19 .RB [ \-sb
20 .IR color ]
21 .RB [ \-sf
22 .IR color ]
23 .RB [ \-ob
24 .IR color ]
25 .RB [ \-of
26 .IR color ]
27 .RB [ \-w
28 .IR windowid ]
29 .P
30 .BR dmenu_run " ..."
31 .SH DESCRIPTION
32 .B dmenu
33 is a dynamic menu for X, which reads a list of newline\-separated items from
34 stdin. When the user selects an item and presses Return, their choice is printed
35 to stdout and dmenu terminates. Entering text will narrow the items to those
36 matching the tokens in the input.
37 .P
38 .B dmenu_run
39 is a script used by
40 .IR dwm (1)
41 which lists programs in the user's $PATH and runs the result in their $SHELL.
42 .SH OPTIONS
43 .TP
44 .B \-b
45 dmenu appears at the bottom of the screen.
46 .TP
47 .B \-f
48 dmenu grabs the keyboard before reading stdin if not reading from a tty. This
49 is faster, but will lock up X until stdin reaches end\-of\-file.
50 .TP
51 .B \-i
52 dmenu matches menu items case insensitively.
53 .TP
54 .BI \-l " lines"
55 dmenu lists items vertically, with the given number of lines.
56 .TP
57 .BI \-m " monitor"
58 dmenu is displayed on the monitor number supplied. Monitor numbers are starting
59 from 0.
60 .TP
61 .BI \-p " prompt"
62 defines the prompt to be displayed to the left of the input field.
63 .TP
64 .BI \-fn " font"
65 defines the font or font set used.
66 .TP
67 .BI \-nb " color"
68 defines the normal background color.
69 .IR #RGB ,
70 .IR #RRGGBB ,
71 and X color names are supported.
72 .TP
73 .BI \-nf " color"
74 defines the normal foreground color.
75 .TP
76 .BI \-sb " color"
77 defines the selected background color.
78 .TP
79 .BI \-sf " color"
80 defines the selected foreground color.
81 .TP
82 .BI \-ob " color"
83 defines the outline background color (for multiple selection).
84 .TP
85 .BI \-of " color"
86 defines the outline foreground color (for multiple selection).
87 .TP
88 .B \-v
89 prints version information to stdout, then exits.
90 .TP
91 .BI \-w " windowid"
92 embed into windowid.
93 .SH USAGE
94 dmenu is completely controlled by the keyboard. Items are selected using the
95 arrow keys, page up, page down, home, and end.
96 .TP
97 .B Tab
98 Copy the selected item to the input field.
99 .TP
100 .B Return
101 Confirm selection. Prints the selected item to stdout and exits, returning
102 success.
103 .TP
104 .B Ctrl-Return
105 Confirm selection. Prints the selected item to stdout and continues.
106 .TP
107 .B Shift\-Return
108 Confirm input. Prints the input text to stdout and exits, returning success.
109 .TP
110 .B Escape
111 Exit without selecting an item, returning failure.
112 .TP
113 .B Ctrl-Left
114 Move cursor to the start of the current word
115 .TP
116 .B Ctrl-Right
117 Move cursor to the end of the current word
118 .TP
119 .B C\-a
120 Home
121 .TP
122 .B C\-b
123 Left
124 .TP
125 .B C\-c
126 Escape
127 .TP
128 .B C\-d
129 Delete
130 .TP
131 .B C\-e
132 End
133 .TP
134 .B C\-f
135 Right
136 .TP
137 .B C\-g
138 Escape
139 .TP
140 .B C\-h
141 Backspace
142 .TP
143 .B C\-i
144 Tab
145 .TP
146 .B C\-j
147 Return
148 .TP
149 .B C\-J
150 Shift-Return
151 .TP
152 .B C\-k
153 Delete line right
154 .TP
155 .B C\-m
156 Return
157 .TP
158 .B C\-M
159 Shift-Return
160 .TP
161 .B C\-n
162 Down
163 .TP
164 .B C\-p
165 Up
166 .TP
167 .B C\-u
168 Delete line left
169 .TP
170 .B C\-w
171 Delete word left
172 .TP
173 .B C\-y
174 Paste from primary X selection
175 .TP
176 .B C\-Y
177 Paste from X clipboard
178 .TP
179 .B M\-b
180 Move cursor to the start of the current word
181 .TP
182 .B M\-f
183 Move cursor to the end of the current word
184 .TP
185 .B M\-g
186 Home
187 .TP
188 .B M\-G
189 End
190 .TP
191 .B M\-h
192 Up
193 .TP
194 .B M\-j
195 Page down
196 .TP
197 .B M\-k
198 Page up
199 .TP
200 .B M\-l
201 Down
202 .SH SEE ALSO
203 .IR dwm (1),
204 .IR stest (1)