dmenu.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
.TH DMENU 1 dmenu-VERSION .SH NAME dmenu \- dynamic menu .SH SYNOPSIS .B dmenu .RB [ \-bottom ] .RB [ \-font " <name>"] .RB [ \-normbg " <color>"] .RB [ \-normfg " <color>"] .RB [ \-selbg " <color>"] .RB [ \-selfg " <color>"] .RB [ \-p " <prompt>"] .RB [ \-t " <seconds>"] .RB [ \-v ] .SH DESCRIPTION .SS Overview dmenu is a generic menu for X, originally designed for .BR dwm (1). It manages huge amounts (up to 10.000 and more) of user defined menu items efficiently. .SS Options .TP .B \-bottom makes dmenu appear at the screen bottom (by default it appears at the screen top). .TP .B \-font <name> defines the font. .TP .B \-normbg <color> defines the normal background color (#RGB, #RRGGBB, and color names are supported). .TP .B \-normfg <color> defines the normal foreground color (#RGB, #RRGGBB, and color names are supported). .TP .B \-selbg <color> defines the selected background color (#RGB, #RRGGBB, and color names are supported). .TP .B \-selfg <color> defines the selected foreground color (#RGB, #RRGGBB, and color names are supported). .TP .B \-p <prompt> defines a prompt to be displayed before the input area. .TP .B \-t <seconds> defines the seconds to wait for standard input, before exiting (default is 3). .TP .B \-v prints version information to standard output, then exits. .SH USAGE dmenu reads a list of newline-separated items from standard input and creates a menu. When the user selects an item or enters any text and presses Return, his/her choice is printed to standard output and dmenu terminates. .P dmenu is completely controlled by the keyboard. The following keys are recognized: .TP .B Any printable character Appends the character to the text in the input field. This works as a filter: only items containing this text will be displayed. .TP .B Left/Right Select the previous/next item. .TP .B PageUp/PageDown Select the first item of the previous/next 'page' of items. .TP .B Home/End Select the first/last item. .TP .B Tab Copy the selected item to the input field. .TP .B Return Confirm selection and quit (print the selected item to standard output). Returns .B 0 on termination. .TP .B Shift-Return Confirm selection and quit (print the text in the input field to standard output). Returns .B 0 on termination. .TP .B Escape Quit without selecting an item. Returns .B 1 on termination. .TP .B Backspace (Control-h) Remove enough characters from the input field to change its filtering effect. .TP .B Control-u Remove all characters from the input field. .SH SEE ALSO .BR dwm (1), .BR wmii (1) .