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