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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
|
.TH bemenu 1 2019-08-07
.SH NAME
bemenu \- Dynamic menu inspired by
.BR dmenu (1)
.SH SYNOPSIS
.B bemenu
.RB [ -hviw ]
.RB [ -l
.IR lines ]
.RB [ -p
.IR prompt ]
.RB [ -P
.IR prefix ]
.RB [ -I
.IR index ]
.RB [ --scrollbar
.IR when ]
.RB [ --ifne ]
.RI [ backend-options ]
.B bemenu-run ...
.SH DESCRIPTION
.B bemenu
is a dynamic menu for
.BR tty (4)
(using
.BR ncurses (3)),
X11 and/or Wayland, inspired by
.RB dmenu (1).
It reads a list of newline-separated items from standard input.
When the user selects an item and presses Return,
their choice is printed to standard output and bemenu terminates.
Entering text will narrow the items to those matching the tokens in the input.
.B bemenu-run
is a special-case invocation of
.BR bemenu ,
where the input is a list of executables in the $PATH directories,
and the selection is executed by the $SHELL.
.SH OPTIONS
.TP
.B \-h, \-\-help
Display bemenu help and exit.
.TP
.B \-v, \-\-version
Display bemenu version and exit.
.TP
.B \-i, \-\-ignorecase
Match items case-insensitively.
.TP
.B \-w, \-\-wrap
Wraps cursor selection.
.TP
.BI \-l \ NUMBER ,\ \-\-list= NUMBER
Lists items vertically with the given \fINUMBER\fR of lines.
.TP
.BI \-p \ PROMPT ,\ \-\-prompt= PROMPT
Defines the \fIPROMPT\fR text to be displayed.
.TP
.BI \-P \ PREFIX ,\ \-\-prefix= PREFIX
Text to show before highlighted item.
.TP
.BI \-I \ INDEX ,\ \-\-index= INDEX
Select item at \fIINDEX\fR automatically.
.TP
.BI \-\-scrollbar= WHEN
Display a scrollbar.
Valid values for \fIWHEN\fR are:
.RS
.TP
.I always
Always show the scrollbar.
.TP
.I autohide
Show scrollbar only when necessary.
.RE
.TP
.B \-\-ifne
Only displays the menu when there are items.
.SS Backend-specific Options
These options are only available on backends specified in the parentheses
(Curses, Wayland and/or X11).
.TP
.BR "\-b, \-\-bottom"
(Wayland, X11) The menu will appear at the bottom of the screen.
.TP
.BR "\-f, \-\-grab"
(Wayland, X11) Show the menu before reading the standard input.
.TP
.BR "\-n, \-\-no\-overlap"
(Wayland) Adjust geometry to not overlap with panels.
.TP
.BI \-m " INDEX" ", \-\-monitor=" INDEX
(X11) Specify \fIINDEX\fR of the monitor where the menu should appear.
.TP
.BI \-H " HEIGHT" ", \-\-line\-height=" HEIGHT
(Wayland, X11) Defines the \fIHEIGHT\fR to make each menu line. Use \fI0\fR for default height.
.TP
.BI \-\-fn " NAME [SIZE]"
(Wayland, X11) Defines the font to be used.
.TP
.BI \-\-tb= COLOR
(Wayland, X11) Defines the title background \fICOLOR\fR.
.TP
.BI \-\-tf= COLOR
(Wayland, X11) Defines the title foreground \fICOLOR\fR.
.TP
.BI \-\-fb= COLOR
(Wayland, X11) Defines the filter background \fICOLOR\fR.
.TP
.BI \-\-ff= COLOR
(Wayland, X11) Defines the filter foreground \fICOLOR\fR.
.TP
.BI \-\-nb= COLOR
(Wayland, X11) Defines the normal background \fICOLOR\fR.
.TP
.BI \-\-nf= COLOR
(Wayland, X11) Defines the normal foreground \fICOLOR\fR.
.TP
.BI \-\-hb= COLOR
(Wayland, X11) Defines the highlighted background \fICOLOR\fR.
.TP
.BI \-\-hf= COLOR
(Wayland, X11) Defines the highlighted foreground \fICOLOR\fR.
.TP
.BI \-\-sb= COLOR
(Wayland, X11) Defines the selected background \fICOLOR\fR.
.TP
.BI \-\-sf= COLOR
(Wayland, X11) Defines the selected foreground \fICOLOR\fR.
.TP
.BI \-\-scb= COLOR
(Wayland, X11) Defines the scrollbar background \fICOLOR\fR.
.TP
.BI \-\-scf= COLOR
(Wayland, X11) Defines the scrollbar foreground \fICOLOR\fR.
.SH EXIT STATUS
0 when the user selects an option, 1 when the user aborts the selection.
.SH ENVIRONMENT
.TP
.B BEMENU_BACKEND
.RS
If set, the appropriate backend will be forced.
If empty, one of the GUI backends (Wayland, X11) will be selected automatically.
The accepted values are:
.TP
.I curses
.BR ncurses (3)
based terminal backend.
.TP
.I wayland
Wayland backend.
.TP
.I x11
X11 backend.
.RE
|
