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)
| Option | Description | Source |
|---|---|---|
--config PATH | load configuration from PATH (XDG_CONFIG_HOME/fuzzel/fuzzel.ini) | help + man |
--check-config | Verify configuration and then exit with 0 if ok, otherwise exit with 1. | help + man |
--cache PATH | load most recently launched applications from PATH (XDG_CACHE_HOME/fuzzel) | help + man |
--override section.].key=VALUE | Override an option set in the configuration file. | help + man |
-n, --namespace NAMESPACE | Specifies the namespace for the spawned layer shell surface. | help + man |
-o, --output OUTPUT | Specifies the monitor to display the window on. | help + man |
-f, --font FONT | Comma separated list of primary font, and fallback fonts, in FontConfig format. | help + man |
--use-bold | Allow fuzzel to use bold fonts. | help + man |
-D, --dpi-aware no|yes|auto | When 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 NAME | icon theme name ("default") | help + man |
-I, --no-icons | Do not render any icons. | help + man |
--hide-before-typing | Hide application list until something is typed. | help + man |
-F, --fields FIELDS | Comma separated list of XDG Desktop entry fields to match against: | help + man |
-p, --prompt PROMPT | string to use as input prompt ("> ") | help + man |
--prompt-only PROMPT | same as --prompt, but in dmenu mode it does not wait for STDIN, and implies --lines=0 | help + man |
--placeholder TEXT | Text to display as placeholder in the input box. | help + man |
--search TEXT | Initial search/filter string. | help + man |
--password CHARACTER | render all input as CHARACTER ('*' by default) | help + man |
--mesg STRING | show informational message above the prompt | help + man |
--mesg-mode wrap|expand | How to handle lines in --mesg when they are longer than --width. | help + man |
-T, --terminal TERMINAL | Command to launch XDG applications with the property Terminal=true (htop, for example). | help + man |
-a, --anchor ANCHOR | Set window anchor, i.e. where on screen the window will be displayed. | help + man |
--x-margin MARGIN | Horizontal margin away from the anchor point in pixels. | help + man |
--y-margin MARGIN | Vertical margin away from the anchor point in pixels. | help + man |
--select STRING | Select the first entry that matches the given string (case insensitive). | help + man |
--auto-select | Automatically select when only one match remains. | help + man |
--select-index INDEX | Select the entry with index, not compatible with --select. | help + man |
-l, --lines COUNT | The (maximum) number of matches to display. | help + man |
--minimal-lines | adjust the number of lines to the minimum of --lines and the number of input lines (dmenu mode only) | help + man |
--hide-prompt | hide the prompt line, making the window smaller (input still accepted) | help + man |
-w, --width | window width, in characters (margins and borders not included) | help + man |
--tabs INT | number of spaces a tab is expanded to (8) | help + man |
-x, --horizontal-pad PAD | Horizontal padding between border and icons and text. | help + man |
-y, --vertical-pad PAD | Vertical padding between border and text. | help + man |
-P, --inner-pad PAD | vertical padding between prompt and match list, in pixels (0) | help + man |
-b, --background-color, --background HEX | background color (fdf6e3ff) | help + man |
-t, --text-color HEX | text color of matched entries (657b83ff) | help + man |
--prompt-color HEX | Text (foreground) color of prompt character(s). | help + man |
--placeholder-color HEX | Text (foreground) color of the placeholder string. | help + man |
--message-color HEX | text color of the message (657b83ff) | help + man |
--input-color HEX | text color of the input string (657b83ff) | help + man |
-m, --match-color HEX | color of matched substring (cb4b16ff) | help + man |
-s, --selection-color HEX | The color to use as background of the currently selected application. | help + man |
-S, --selection-text-color HEX | The text color of the currently selected application. | help + man |
--selection-radius INT | The border radius of the selection entry. | help + man |
--counter-color HEX | The color of the match count stats printed at the right-hand side of the input prompt. | help + man |
-B, --border-width INT | The width of the surrounding border, in pixels (subject to output scaling). | help + man |
-r, --border-radius INT | The corner curvature, subject to output scaling. | help + man |
-C, --border-color HEX | The color of the border. | help + man |
--show-actions | Include desktop actions in the list. | help + man |
--filter-desktop no | Filter the visible desktop entries based on the value of XDG_CURRENT_DESKTOP. | help + man |
--fuzzy-min-length VALUE | search strings shorter than this will not be fuzzy matched (3) | help + man |
--fuzzy-max-length-discrepancy VALUE | maximum allowed length discrepancy between a fuzzy match and the search criteria. | help + man |
--fuzzy-max-distance VALUE | Maximum allowed levenshtein distance between the search string, and a fuzzy match. | help + man |
--line-height HEIGHT | Override line height from font metrics. | help + man |
--letter-spacing AMOUNT | Additional space between letters. | help + man |
--layer top|overlay | which layer to render the fuzzel window on (top) | help + man |
--keyboard-focus exclusive|on-demand | Keyboard focusing mode, valid modes are exclusive and on-demand. | help + man |
--no-exit-on-keyboard-focus-loss | Do not exit when losing keyboard focus. | help + man |
--launch-prefix COMMAND | prefix to add before argv of executed program | help + man |
--list-executables-in-path | Include executables from the PATH environment variable. | help + man |
--render-workers N | Number of threads to use for rendering. | help + man |
--match-workers N | Number of threads to use for matching. | help + man |
--no-sort | Do not sort the result. | help + man |
--counter | Display the match count. | help + man |
--delayed-filter-limit N | When there are more matches than this, switch from immediate refiltering to delayed refiltering (see --delayed-filter-ms). | help + man |
--scaling-filter FILTER | Scaling filter to use when down scaling PNGs. | help + man |
-d, --dmenu | dmenu compatibility mode. | help + man |
--dmenu0 | Like --dmenu, but input is NUL separated instead of newline separated. | help + man |
--index | print selected entry's index instead of of the entry's text (dmenu mode only) | help + man |
--with-nth N|FMT | Display the N:th column (1-based, tab separated by default, see --nth-delimiter) of each input line. | help + man |
--accept-nth N|FMT | Output the N:th column (1-based, tab separated by default, see --nth-delimiter) of each input line to stdout. | help + man |
--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) | help + man |
--nth-delimiter CHARACTER | Field (column) delimiter for --with-nth and --accept-nth. | help + man |
--only-match | Do not allow custom entries, only return a selected item. | help + man |
-R, --no-run-if-empty | exit immediately without showing UI if stdin is empty (dmenu mode only) | help + man |
--log-level info|warning|error|none | Log level, used both for log output on stderr as well as syslog. | help + man |
--log-colorize never|always|auto | Enables or disables colorization of log output on stderr. | help + man |
--log-no-syslog | Disables syslog logging. | help + man |
--print-timing-info | print timing information, to help debug performance issues | help + man |
--no-mouse | Disable mouse input. | help + man |
-v, --version | show the version number and quit | help + man |
--gamma-correct | Do gamma-correct blending in linear color space. (in the manual page but not in --help) | man |
-i | Ignored; (in the manual page but not in --help) | man |
-M, --selection-match-color HEX | The color of matching substring(s) of the currently selected application. (in the manual page but not in --help) | man |
--match-mode exact|fzf|fuzzy | Defines how what you type is matched. (in the manual page but not in --help) | man |
--delayed-filter-ms TIME_MS | Time, in milliseconds, to delay refiltering when there are more matches than --delayed-filter-limit. (in the manual page but not in --help) | man |