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

Font and style to use, in fontconfig format. See Font Format. Default: monospace.

-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.

-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.

-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.

-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-03-08