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
.TH DMENU 1 dmenu\-3.2 .SH NAME dmenu \- dynamic menu .SH SYNOPSIS .B dmenu .RB [ \-b ] .RB [ \-fn " <font>"] .RB [ \-nb " <color>"] .RB [ \-nf " <color>"] .RB [ \-p " <prompt>"] .RB [ \-sb " <color>"] .RB [ \-sf " <color>"] .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 \-b makes dmenu appear at the screen bottom (by default it appears at the screen top). .TP .B \-fn <font> defines the font. .TP .B \-nb <color> defines the normal background color (#RGB, #RRGGBB, and color names are supported). .TP .B \-nf <color> defines the normal 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 \-sb <color> defines the selected background color (#RGB, #RRGGBB, and color names are supported). .TP .B \-sf <color> defines the selected foreground color (#RGB, #RRGGBB, and color names are supported). .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 (Mod1\-h/Mod1\-l) Select the previous/next item. .TP .B PageUp/PageDown (Mod1\-k/Mod1\-j) Select the first item of the previous/next 'page' of items. .TP .B Home/End (Mod1\-g/Mod1\-G) Select the first/last item. .TP .B Tab (Control\-i) Copy the selected item to the input field. .TP .B Return (Control\-j) Confirm selection and quit (print the selected item to standard output). Returns .B 0 on termination. .TP .B Shift\-Return (Control\-Shift\-j) Confirm selection and quit (print the text in the input field to standard output). Returns .B 0 on termination. .TP .B Escape (Control\-bracketleft) Quit without selecting an item. Returns .B 1 on termination. .TP .B Backspace (Control\-h) Remove a character from the input field. .TP .B Control\-u Remove all characters from the input field. .TP .B Control\-w Remove all characters of current word from the input field. .SH SEE ALSO .BR dwm (1), .BR wmii (1) .