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              always Always show the scrollbar.
66
67              autohide
68                     Show scrollbar only when necessary.
69
70
71       --ifne Only displays the menu when there are items.
72
73
74   Backend-specific Options
75       These options are only available on backends specified in the parenthe‐
76       ses (Curses, Wayland and/or X11).
77
78
79       -b, --bottom
80              (Wayland, X11) The menu will appear at the bottom of the screen.
81
82
83       -f, --grab
84              (Wayland, X11) Show the menu before reading the standard input.
85
86
87       -n, --no-overlap
88              (Wayland) Adjust geometry to not overlap with panels.
89
90
91       -m INDEX, --monitor=INDEX
92              (X11) Specify INDEX of the monitor where the menu should appear.
93
94
95       -H HEIGHT, --line-height=HEIGHT
96              (Wayland, X11) Defines the HEIGHT to make each menu line. Use  0
97              for default height.
98
99
100       --fn NAME [SIZE]
101              (Wayland, X11) Defines the font to be used.
102
103
104       --tb=COLOR
105              (Wayland, X11) Defines the title background COLOR.
106
107
108       --tf=COLOR
109              (Wayland, X11) Defines the title foreground COLOR.
110
111
112       --fb=COLOR
113              (Wayland, X11) Defines the filter background COLOR.
114
115
116       --ff=COLOR
117              (Wayland, X11) Defines the filter foreground COLOR.
118
119
120       --nb=COLOR
121              (Wayland, X11) Defines the normal background COLOR.
122
123
124       --nf=COLOR
125              (Wayland, X11) Defines the normal foreground COLOR.
126
127
128       --hb=COLOR
129              (Wayland, X11) Defines the highlighted background COLOR.
130
131
132       --hf=COLOR
133              (Wayland, X11) Defines the highlighted foreground COLOR.
134
135
136       --sb=COLOR
137              (Wayland, X11) Defines the selected background COLOR.
138
139
140       --sf=COLOR
141              (Wayland, X11) Defines the selected foreground COLOR.
142
143
144       --scb=COLOR
145              (Wayland, X11) Defines the scrollbar background COLOR.
146
147
148       --scf=COLOR
149              (Wayland, X11) Defines the scrollbar foreground COLOR.
150
151

EXIT STATUS

153       0  when  the  user selects an option, 1 when the user aborts the selec‐
154       tion.
155
156

ENVIRONMENT

158       BEMENU_BACKEND
159              If set, the appropriate backend will be forced.  If  empty,  one
160              of  the  GUI  backends (Wayland, X11) will be selected automati‐
161              cally.
162
163              The accepted values are:
164
165              curses ncurses(3) based terminal backend.
166
167              wayland
168                     Wayland backend.
169
170              x11    X11 backend.
171
172
173
174                                  2019-08-07                         bemenu(1)
Impressum