bemenu - Man Page

These options are only available on backends specified in the parentheses:

-b,  --bottom (Wayland, X11)

The list will appear at the bottom of the screen.

-c,  --center (Wayland, X11)

The list will appear at the center of the screen. (wx)

-f,  --grab (Wayland, X11)

Show the bemenu window whilst reading the items.

-B,  --border (Wayland, X11)

Specify the width of the border in pixels around the menu.

--bdr (Wayland, X11)

Specify the border color.

-R,  --border-radius (Wayland, X11)

Specify the radius of the border around the menu (0 = no curved borders).

-H,  --line-height <height> (Wayland, X11)

Specify the height in point size to make each entry.

--ch (Wayland, X11)

Specify the height of the cursor (0 = scales with line height).

--cw (Wayland, X11)

Specify the width of the cursor.

-m,  --monitor <index> (Wayland, X11)

Specify the monitor index where the list should appear. Monitor indices start at zero. The interpretation of the given argument depends on the utilized backend. With X11 and Wayland, a value of ‘-1’ or focused indicates that the current monitor should be used (the default). With Wayland, the index should be a string specifying a specific monitor name. The value ‘-2’ or all indicates that the list should appear on all monitors.

-n,  --no-overlap (Wayland)

Set the bemenu window to be on top of any other panels.

-M,  --margin <margin> (Wayland, X11)

Specify the margin (empty space) in pixels to leave between menu and vertical view borders. bemenu will reduce it's size to fit in space between gaps.

--hp (Wayland, X11)

Specify the horizontal padding for the entries in single line mode.

-W,  --width-factor <factor> (Wayland, X11)

Specify the relative width factor as a floating point number. It makes sense to set it between 0 and 1 to define how much of the screen width bemenu will use. However, bemenu will still respect margin, so if resulting size is greater than space between gaps, bemenu will ignore factor and use available space instead.

--fn <name [size]> (Wayland, X11)

Specify the font family name and size to be used. For more options, consult the Pango Reference Manual for pango_font_description_from_string().

The following options control the colours for various parts of the list for the Wayland and X11 backends. Each takes an argument in the form of:

where R, G, B and A are hexadecimal integers from 00–FF that control the red, green, blue and alpha-transparency channels.

--tb <color> Title background.

--tf <color> Title foreground.

--fb <color> Filter background.

--ff <color> Filter foreground

--cb <color> Cursor background.

--cf <color> Cursor foreground

--nb <color> Normal background.

--nf <color> Normal foreground.

--hb <color> Highlighted background.

--hf <color> Highlighted foreground.

--fbb <color> Feedback background.

--fbf <color> Feedback foreground.

--sb <color> Selected background.

--sf <color> Selected foreground.

--ab <color> Alternating background color.

--af <color> Alternating foreground color.

--scb <color> Scrollbar background.

--scf <color> Scrollbar foreground.

bemenu uses vim-like modal entry if invoked with --binding vim. These bindings roughly emulate insert and normal vim modes. The initial mode is insert mode, unless --vim-normal-mode is specified.

In insert mode, all keys function as described above except for the following:

<escape>

Switch to normal mode.

In normal mode, only the following keys have meaning:

q

Terminate bemenu without printing items.

i

Enter insert mode.

I

Enter insert mode after moving the cursor to the start.

a

Enter insert mode after moving the cursor right.

A

Enter insert mode after moving the cursor to the end.

cc

Enter insert mode after clearing the filter.

cw

Enter insert mode after removing all characters between the cursor and the start of the next word.

cb

Enter insert mode after removing all characters between the start of the word and the cursor.

c$

Enter insert mode after removing all characters after the cursor.

c0

Enter insert mode after removing all characters before the cursor.

n, j

Highlight the next item.

p, k

Highlight the previous item.

gg

Highlight the first item in the list.

G

Highlight the last item in the list.

H

Highlight the first visible item.

M

Highlight the middle-most visible item.

L

Highlight the last visible item.

v

Select or deselect the higlighted item.

F

Show the next page of items.

B

Show the previous page of items.

h

Move cursor left.

l

Move cursor right.

0

Move cursor to the start.

$

Move cursor to the end.

w

Move cursor forward to the start of a word.

b

Move cursor backward to the start of a word.

e

Move cursor forward to the end of a word.

x

Remove character at the cursor.

X

Remove character before the cursor.

dw

Remove all characters between the cursor and start of the next word.

db

Remove all characters between the start of the word and the cursor.

d$

Remove all characters after the cursor.

d0

Remove all characters before the cursor.

dd

Clear the filter.