OS Manuals

/usr/bin/fuzzel

Wayland-native application launcher and fuzzy finder, inspired by rofi and dmenu

From fuzzel 1.15.0-r3 (enterprise-packages), captured 2026-11-08 by running fuzzel --help (exit 0). permalink

Usage: /usr/bin/fuzzel [OPTION]...

Options:
     --config=PATH               load configuration from PATH
                                 (XDG_CONFIG_HOME/fuzzel/fuzzel.ini)
     --check-config              verify configuration, exit with 0 if ok,
                                 otherwise exit with 1
     --cache=PATH                load most recently launched applications from
                                 PATH (XDG_CACHE_HOME/fuzzel)
     --override=[section.].key=VALUE  override configuration value
  -n,--namespace=NAMESPACE       layer shell surface namespace
  -o,--output=OUTPUT             output (monitor) to display on (none)
  -f,--font=FONT                 font name and style, in FontConfig format
                                 (monospace)
     --use-bold                  allow fuzzel to use bold fonts
  -D,--dpi-aware=no|yes|auto     enable or disable DPI aware rendering (auto)
     --icon-theme=NAME           icon theme name ("default")
  -I,--no-icons                  do not render any icons
     --hide-before-typing    hide application list until something is typed
  -F,--fields=FIELDS             comma separated list of XDG Desktop entry
                                 fields to match
  -p,--prompt=PROMPT             string to use as input prompt ("> ")
     --prompt-only=PROMPT        same as --prompt, but in dmenu mode it does not
                                 wait for STDIN, and implies --lines=0
     --placeholder=TEXT          placeholder text in input box
     --search=TEXT               initial search/filter string
     --password=[CHARACTER]      render all input as CHARACTER ('*' by default)
     --mesg                      show informational message above the prompt
     --mesg-mode=wrap|expand     how to deal with message lines longer than
                                 the ui (wrap)
  -T,--terminal                  terminal command to use when launching
                                 'terminal' programs, e.g. "xterm -e".
                                 Not used in dmenu mode (not set)
  -a,--anchor                    window anchor (center)
     --x-margin=MARGIN           horizontal margin, in pixels (0)
     --y-margin=MARGIN           vertical margin, in pixels (0)
     --select=STRING             select first entry that matches the given
                                 string
     --auto-select               automatically select when only one match
                                 remains
     --select-index=INDEX        select the entry with index, not compatible with --select
  -l,--lines                     number of matches to show
     --minimal-lines             adjust the number of lines to the
                                 minimum of --lines and the number
                                 of input lines (dmenu mode only)
     --hide-prompt               hide the prompt line, making the window
                                 smaller (input still accepted)
  -w,--width                     window width, in characters (margins and
                                 borders not included)
     --tabs=INT                  number of spaces a tab is expanded to (8)
  -x,--horizontal-pad=PAD        horizontal padding, in pixels (40)
  -y,--vertical-pad=PAD          vertical padding, in pixels (8)
  -P,--inner-pad=PAD             vertical padding between prompt and match list,
                                 in pixels (0)
  -b,--background-color=HEX      background color (fdf6e3ff)
  -t,--text-color=HEX            text color of matched entries (657b83ff)
     --prompt-color=HEX          text color of the prompt (586e75ff)
     --placeholder-color=HEX     text color of the placeholder text (93a1a1)
     --message-color=HEX         text color of the message (657b83ff)
     --input-color=HEX           text color of the input string (657b83ff)
  -m,--match-color=HEX           color of matched substring (cb4b16ff)
  -s,--selection-color=HEX       background color of selected item (eee8d5ff)
  -S,--selection-text-color=HEX  text color of selected item (586e75ff)
  -M,--selection-match-color=HEX color of matched substring in selection
                                 (cb4b16ff)
     --selection-radius          border radius of the selected entry (0)
     --counter-color             color of the match count (93a1a1)
  -B,--border-width=INT          width of border, in pixels (1)
  -r,--border-radius=INT         amount of corner "roundness" (10)
  -C,--border-color=HEX          border color (002b36ff)
     --show-actions              include desktop actions in the list
     --match-mode=exact|fzf|fuzzy how to match what you type against the entries
     --filter-desktop            filter desktop entries based on XDG_CURRENT
     --fuzzy-min-length=VALUE    search strings shorter than this will not be
                                 fuzzy matched (3)
     --fuzzy-max-length-discrepancy=VALUE  maximum allowed length discrepancy
                                           between a fuzzy match and the search
                                           criteria. Larger values mean more
                                           fuzzy matches (2)
     --fuzzy-max-distance=VALUE  maximum levenshtein distance between a fuzzy
                                 match and the search criteria. Larger values
                                 mean more fuzzy matches
     --line-height=HEIGHT        override line height from font metrics
     --letter-spacing=AMOUNT     additional letter spacing
     --layer=top|overlay         which layer to render the fuzzel window on
                                 (top)
     --keyboard-focus=exclusive|on-demand  keyboard focus mode (exclusive)
     --no-exit-on-keyboard-focus-loss  do not exit when losing keyboard focus
     --launch-prefix=COMMAND     prefix to add before argv of executed program
     --list-executables-in-path  include executables from PATH in the list
     --render-workers=N          number of threads to use for rendering
     --match-workers=N           number of threads to use for matching
     --no-sort                   do not sort the result
     --counter                   display the match count
     --delayed-filter-ms=TIME_MS time in ms before refiltering after a keystroke
                                 (300)
     --delayed-filter-limit=N    used delayed refiltering when the number of
                                 matches exceeds this number (10000)
     --scaling-filter=FILTER     filter to use when down scaling PNGs
  -d,--dmenu                     dmenu compatibility mode
     --dmenu0                    like --dmenu, but input is NUL separated
                                 instead of newline separated
     --index                     print selected entry's index instead of of the
                                 entry's text (dmenu mode only)
     --with-nth=N|FMT            display the N:th column (tab separated by
                                 default) of each input line (dmenu only)
     --accept-nth=N|FMT          output the N:th column (tab separated by
                                 default) of each input line (dmenu only)
     --match-nth=N|FMT           match against the N:th column (tab separated by
                                 default) of each input line, instead of what is
                                 being displayed (dmenu only)
     --nth-delimiter=CHARACTER   field (column) character, for --with-nth and
                                 --accept-nth
     --only-match                do not allow custom entries, only return a
                                 selected item
  -R,--no-run-if-empty           exit immediately without showing UI if stdin
                                 is empty (dmenu mode only)
     --log-level={info|warning|error|none}
                                 log level (warning)
     --log-colorize=[never|always|auto]
                                 enable/disable colorization of log output on
                                 stderr
     --log-no-syslog             disable syslog logging
     --print-timing-info         print timing information, to help debug
                                 performance issues
     --no-mouse                  disable mouse input
  -v,--version                   show the version number and quit

All colors are RGBA - i.e. 8-digit hex values, without prefix.
Options (87)
OptionDescriptionSource
--config PATHload configuration from PATH (XDG_CONFIG_HOME/fuzzel/fuzzel.ini)help + man
--check-configVerify configuration and then exit with 0 if ok, otherwise exit with 1.help + man
--cache PATHload most recently launched applications from PATH (XDG_CACHE_HOME/fuzzel)help + man
--override section.].key=VALUEOverride an option set in the configuration file.help + man
-n, --namespace NAMESPACESpecifies the namespace for the spawned layer shell surface.help + man
-o, --output OUTPUTSpecifies the monitor to display the window on.help + man
-f, --font FONTComma separated list of primary font, and fallback fonts, in FontConfig format.help + man
--use-boldAllow fuzzel to use bold fonts.help + man
-D, --dpi-aware no|yes|autoWhen set to yes, fonts are sized using the monitor's DPI, making a font of a given point size have the same physical size, regardless of monitor.help + man
--icon-theme NAMEicon theme name ("default")help + man
-I, --no-iconsDo not render any icons.help + man
--hide-before-typingHide application list until something is typed.help + man
-F, --fields FIELDSComma separated list of XDG Desktop entry fields to match against:help + man
-p, --prompt PROMPTstring to use as input prompt ("> ")help + man
--prompt-only PROMPTsame as --prompt, but in dmenu mode it does not wait for STDIN, and implies --lines=0help + man
--placeholder TEXTText to display as placeholder in the input box.help + man
--search TEXTInitial search/filter string.help + man
--password CHARACTERrender all input as CHARACTER ('*' by default)help + man
--mesg STRINGshow informational message above the prompthelp + man
--mesg-mode wrap|expandHow to handle lines in --mesg when they are longer than --width.help + man
-T, --terminal TERMINALCommand to launch XDG applications with the property Terminal=true (htop, for example).help + man
-a, --anchor ANCHORSet window anchor, i.e. where on screen the window will be displayed.help + man
--x-margin MARGINHorizontal margin away from the anchor point in pixels.help + man
--y-margin MARGINVertical margin away from the anchor point in pixels.help + man
--select STRINGSelect the first entry that matches the given string (case insensitive).help + man
--auto-selectAutomatically select when only one match remains.help + man
--select-index INDEXSelect the entry with index, not compatible with --select.help + man
-l, --lines COUNTThe (maximum) number of matches to display.help + man
--minimal-linesadjust the number of lines to the minimum of --lines and the number of input lines (dmenu mode only)help + man
--hide-prompthide the prompt line, making the window smaller (input still accepted)help + man
-w, --widthwindow width, in characters (margins and borders not included)help + man
--tabs INTnumber of spaces a tab is expanded to (8)help + man
-x, --horizontal-pad PADHorizontal padding between border and icons and text.help + man
-y, --vertical-pad PADVertical padding between border and text.help + man
-P, --inner-pad PADvertical padding between prompt and match list, in pixels (0)help + man
-b, --background-color, --background HEXbackground color (fdf6e3ff)help + man
-t, --text-color HEXtext color of matched entries (657b83ff)help + man
--prompt-color HEXText (foreground) color of prompt character(s).help + man
--placeholder-color HEXText (foreground) color of the placeholder string.help + man
--message-color HEXtext color of the message (657b83ff)help + man
--input-color HEXtext color of the input string (657b83ff)help + man
-m, --match-color HEXcolor of matched substring (cb4b16ff)help + man
-s, --selection-color HEXThe color to use as background of the currently selected application.help + man
-S, --selection-text-color HEXThe text color of the currently selected application.help + man
--selection-radius INTThe border radius of the selection entry.help + man
--counter-color HEXThe color of the match count stats printed at the right-hand side of the input prompt.help + man
-B, --border-width INTThe width of the surrounding border, in pixels (subject to output scaling).help + man
-r, --border-radius INTThe corner curvature, subject to output scaling.help + man
-C, --border-color HEXThe color of the border.help + man
--show-actionsInclude desktop actions in the list.help + man
--filter-desktop noFilter the visible desktop entries based on the value of XDG_CURRENT_DESKTOP.help + man
--fuzzy-min-length VALUEsearch strings shorter than this will not be fuzzy matched (3)help + man
--fuzzy-max-length-discrepancy VALUEmaximum allowed length discrepancy between a fuzzy match and the search criteria.help + man
--fuzzy-max-distance VALUEMaximum allowed levenshtein distance between the search string, and a fuzzy match.help + man
--line-height HEIGHTOverride line height from font metrics.help + man
--letter-spacing AMOUNTAdditional space between letters.help + man
--layer top|overlaywhich layer to render the fuzzel window on (top)help + man
--keyboard-focus exclusive|on-demandKeyboard focusing mode, valid modes are exclusive and on-demand.help + man
--no-exit-on-keyboard-focus-lossDo not exit when losing keyboard focus.help + man
--launch-prefix COMMANDprefix to add before argv of executed programhelp + man
--list-executables-in-pathInclude executables from the PATH environment variable.help + man
--render-workers NNumber of threads to use for rendering.help + man
--match-workers NNumber of threads to use for matching.help + man
--no-sortDo not sort the result.help + man
--counterDisplay the match count.help + man
--delayed-filter-limit NWhen there are more matches than this, switch from immediate refiltering to delayed refiltering (see --delayed-filter-ms).help + man
--scaling-filter FILTERScaling filter to use when down scaling PNGs.help + man
-d, --dmenudmenu compatibility mode.help + man
--dmenu0Like --dmenu, but input is NUL separated instead of newline separated.help + man
--indexprint selected entry's index instead of of the entry's text (dmenu mode only)help + man
--with-nth N|FMTDisplay the N:th column (1-based, tab separated by default, see --nth-delimiter) of each input line.help + man
--accept-nth N|FMTOutput the N:th column (1-based, tab separated by default, see --nth-delimiter) of each input line to stdout.help + man
--match-nth N|FMTmatch against the N:th column (tab separated by default) of each input line, instead of what is being displayed (dmenu only)help + man
--nth-delimiter CHARACTERField (column) delimiter for --with-nth and --accept-nth.help + man
--only-matchDo not allow custom entries, only return a selected item.help + man
-R, --no-run-if-emptyexit immediately without showing UI if stdin is empty (dmenu mode only)help + man
--log-level info|warning|error|noneLog level, used both for log output on stderr as well as syslog.help + man
--log-colorize never|always|autoEnables or disables colorization of log output on stderr.help + man
--log-no-syslogDisables syslog logging.help + man
--print-timing-infoprint timing information, to help debug performance issueshelp + man
--no-mouseDisable mouse input.help + man
-v, --versionshow the version number and quithelp + man
--gamma-correctDo gamma-correct blending in linear color space. (in the manual page but not in --help)man
-iIgnored; (in the manual page but not in --help)man
-M, --selection-match-color HEXThe color of matching substring(s) of the currently selected application. (in the manual page but not in --help)man
--match-mode exact|fzf|fuzzyDefines how what you type is matched. (in the manual page but not in --help)man
--delayed-filter-ms TIME_MSTime, in milliseconds, to delay refiltering when there are more matches than --delayed-filter-limit. (in the manual page but not in --help)man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.