1bemenu(1)                   General Commands Manual                  bemenu(1)
2
3
4

NAME

6       bemenu - Dynamic menu inspired by dmenu(1)
7
8

SYNOPSIS

10       bemenu [-hviw] [-l lines] [-p prompt] [-P prefix] [-I index] [--scroll‐
11       bar when] [--ifne] [backend-options]
12
13       bemenu-run ...
14
15

DESCRIPTION

17       bemenu is a dynamic menu for tty(4) (using ncurses(3)), X11 and/or Way‐
18       land, inspired by dmenu(1).  It reads a list of newline-separated items
19       from standard input.  When the user selects an item and presses Return,
20       their  choice  is  printed  to  standard  output and bemenu terminates.
21       Entering text will narrow the items to those matching the tokens in the
22       input.
23
24       bemenu-run is a special-case invocation of bemenu, where the input is a
25       list of executables in the $PATH directories, and  the  selection  gets
26       executed.
27
28

OPTIONS

30       -h, --help
31              Display bemenu help and exit.
32
33
34       -v, --version
35              Display bemenu version and exit.
36
37
38       -i, --ignorecase
39              Match items case-insensitively.
40
41
42       -w, --wrap
43              Wraps cursor selection.
44
45
46       -l NUMBER, --list=NUMBER
47              Lists items vertically with the given NUMBER of lines.
48
49
50       -p PROMPT, --prompt=PROMPT
51              Defines the PROMPT text to be displayed.
52
53
54       -P PREFIX, --prefix=PREFIX
55              Text to show before highlighted item.
56
57
58       -I INDEX, --index=INDEX
59              Select item at INDEX automatically.
60
61
62       --scrollbar=WHEN
63              Display a scrollbar.  Valid values for WHEN are:
64
65              none   Never show the scrollbar. (default)
66
67              always Always show the scrollbar.
68
69              autohide
70                     Show scrollbar only when necessary.
71
72
73       --ifne Only displays the menu when there are items.
74
75
76       --fork Always  fork.  (bemenu-run)  By  default terminal backends won't
77              fork.
78
79
80       --no-exec
81              Do not execute command.  (bemenu-run)  Instead  of  running  the
82              selected item, send to stdout.
83
84
85   Backend-specific Options
86       These options are only available on backends specified in the parenthe‐
87       ses (Curses, Wayland and/or X11).
88
89
90       -b, --bottom
91              (Wayland, X11) The menu will appear at the bottom of the screen.
92
93
94       -f, --grab
95              (Wayland, X11) Show the menu before reading the standard input.
96
97
98       -n, --no-overlap
99              (Wayland) Adjust geometry to not overlap with panels.
100
101
102       -m INDEX, --monitor=INDEX
103              (Wayland, X11) Specify INDEX  of  the  monitor  where  the  menu
104              should  appear.   (Wayland)  If index is -1 or all then the menu
105              will appear on all monitors.
106
107
108       -H HEIGHT, --line-height=HEIGHT
109              (Wayland, X11) Defines the HEIGHT to make each menu line. Use  0
110              for default height.
111
112
113       --fn NAME [SIZE]
114              (Wayland, X11) Defines the font to be used.
115
116
117       --tb=COLOR
118              (Wayland, X11) Defines the title background COLOR.
119
120
121       --tf=COLOR
122              (Wayland, X11) Defines the title foreground COLOR.
123
124
125       --fb=COLOR
126              (Wayland, X11) Defines the filter background COLOR.
127
128
129       --ff=COLOR
130              (Wayland, X11) Defines the filter foreground COLOR.
131
132
133       --nb=COLOR
134              (Wayland, X11) Defines the normal background COLOR.
135
136
137       --nf=COLOR
138              (Wayland, X11) Defines the normal foreground COLOR.
139
140
141       --hb=COLOR
142              (Wayland, X11) Defines the highlighted background COLOR.
143
144
145       --hf=COLOR
146              (Wayland, X11) Defines the highlighted foreground COLOR.
147
148
149       --sb=COLOR
150              (Wayland, X11) Defines the selected background COLOR.
151
152
153       --sf=COLOR
154              (Wayland, X11) Defines the selected foreground COLOR.
155
156
157       --scb=COLOR
158              (Wayland, X11) Defines the scrollbar background COLOR.
159
160
161       --scf=COLOR
162              (Wayland, X11) Defines the scrollbar foreground COLOR.
163
164

EXIT STATUS

166       0  when  the  user selects an option, 1 when the user aborts the selec‐
167       tion.
168
169

ENVIRONMENT

171       BEMENU_OPTS
172              Alternative way to pass any command line argument from the envi‐
173              ronment.
174
175
176       BEMENU_BACKEND
177              If  set,  the appropriate backend will be forced.  If empty, one
178              of the GUI backends (Wayland, X11) will  be  selected  automati‐
179              cally.
180
181              The accepted values are:
182
183              curses ncurses(3) based terminal backend.
184
185              wayland
186                     Wayland backend.
187
188              x11    X11 backend.
189
190
191       BEMENU_RENDERER
192              Force backend by loading a .so file.
193
194
195       BEMENU_RENDERERS
196              Override the backend search path.
197
198
199       BEMENU_SCALE
200              Override the rendering scale factor.
201
202
203
204                                  2019-08-07                         bemenu(1)