fuzzel - Man Page

display XDG applications in a searchable Wayland window

Synopsis

fuzzel [OPTIONS]...

Description

fuzzel lists all available XDG applications in a searchable Window. The search box supports Emacs-like key bindings.

The window size, font and colors can be configured with command line options:

-o,--output=OUTPUT

Specifies the monitor to display the window on. In Sway, you can list the available outputs with swaymsg -t get_outputs.

The default is to let the compositor choose output.

-f,--font=FONT[,FALLBACK1,FALLBACK2,...]

Comma separated list of primary font, and fallback fonts, in FontConfig format. See Font Format. Default: monospace.

-P,--prompt=PROMPT

Prompt to use. Default: > .

-i,--icon-theme=NAME

Icon theme to use. Example: Adwaita. Default: hicolor.

-I,--no-icons

Do not render any icons.

-T,--terminal=TERMINAL ARGS

Command to launch XDG applications with the property Terminal=true (htop, for example). Example: xterm -e. Default: not set.

-l,--lines=COUNT

The (maximum) number of matches to display. This dictates the window height. Default: 15.

-w,--width

Window width, in characters. Margins and borders not included. Default: 30.

-x,--horizontal-pad=PAD

Horizontal padding between border and icons and text. In pixels, subject to output scaling. Default: 40.

-y,--vertical-pad=PAD

Vertical padding between border and text. In pixels, subject to output scaling. Default: 8.

-p,--inner-pad=PAD

Vertical padding between prompt and match list. In pixels, subject to output scaling. Default: 0.

-b,--background=HEX

Background color. See Colors. Default: fdf6e3dd.

-t,--text-color=HEX

Text color. See Colors. Default: 657b83ff.

-m,--match-color=HEX

The color of matching substring(s). As you start typing in the search box, the matching part in each application's name is highlighted with this color. See Colors. Default: cb4b16ff.

-s,--selection-color=HEX

The color to use as background of the currently selected application. See Colors. Default: eee8d5ff.

-S,--selection-text-color=HEX

The text color of the currently selected application. See Colors. Default: 0x657b83ff.

-B,--border-width=INT

The width of the surrounding border, in pixels (subject to output scaling). Default: 1.

-r,--border-radius=INT

The corner curvature. Larger means more rounded corners. 0 disables rounded corners. Default: 10.

-C,--border-color=HEX

The color of the border. See Colors. Default: 002b36ff.

-d,--dmenu

dmenu compatibility mode. In this mode, the list entries are read from stdin (newline separated). The selected entry is printed to stdout. If the input string does not match any of the entries, the input string is printed as is on stdout.

-R,--no-run-if-empty

Exit immediately, without showing the UI, if stdin is empty. dmenu mode only.

--line-height=HEIGHT

Override line height from font metrics. In points by default, but can be specified as pixels by appending 'px' (i.e. --line-height=16px). Default: not set.

--letter-spacing=AMOUNT

Additional space between letters. In points by default, but can be specified as pixels by appending 'px' (i.e. letter-spacing=5px). Negative values are supported. Default: 0.

-v,--version

Show the version number and quit

Font Format

The font is specified in FontConfig syntax. That is, a colon-separated list of font name and font options.

Examples:
  • Dina:weight=bold:slant=italic
  • Arial:size=12

Colors

All colors must be specified as a RGBA quadruple, in hex format, without a leading '0x'.

EXAMPLES:
  • white: ffffffff (no transparency)
  • black: 000000ff (no transparency)
  • black: 00000010 (semi-transparent)
  • red: ff0000ff (no transparency)

The default color scheme is Solarized.

Info

2021-09-24