.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "fuzzel" "1" "2025-09-23"
.PP
.SH NAME
fuzzel - Wayland app launcher and picker
.PP
.SH SYNOPSIS
\fBfuzzel\fR [\fIOPTIONS\fR].\&.\&.\&
.PP
.SH DESCRIPTION
.PP
As a launcher, \fBfuzzel\fR lists all available XDG applications in a searchable
window.\&
.PP
With the \fB--dmenu\fR flag, fuzzel works like a general-purpose picker like dmenu, rofi or fzf.\&
Options to choose from are provided on the STDIN and the selected option is printed to STDOUT.\&
.PP
The search box supports Emacs-like key bindings.\&
.PP
Many things can be configured with \fBfuzzel.\&ini\fR(5) or command line options:
.PP
\fB--config\fR=\fIPATH\fR
.RS 4
Path to configuration file, see \fBfuzzel.\&ini\fR(5) for details.\&
.PP
.RE
\fB--check-config\fR
.RS 4
Verify configuration and then exit with 0 if ok, otherwise exit
with 1.\&
.PP
.RE
\fB-n\fR,\fB--namespace\fR=\fINAMESPACE\fR
.RS 4
Specifies the namespace for the spawned layer shell surface.\& Useful for
blocking fuzzel out from screencasts in your compositor if it shows
sensitive information, such as passwords.\&
.PP
Default: \fIlauncher\fR
.PP
.RE
\fB--cache\fR=\fIPATH\fR
.RS 4
Use a custom cache location.\& Fuzzel uses this file to cache the
most commonly launched applications (to be able to sort them at
the top).\&
.PP
You can also use this option to enable caching of dmenu
entries.\& It is recommended that you use a separate cache file for
each "type" of dmenu invocation; i.\&e.\& one for the browser history,
another for emojis etc.\&
.PP
Set to /dev/null to disable caching.\&
.PP
Default: \fIXDG_CACHE_HOME/fuzzel\fR
.PP
.RE
\fB-o\fR,\fB--output\fR=\fIOUTPUT\fR
.RS 4
Specifies the monitor to display the window on.\& Autocompletion is available
for zsh and fish, or you can list the available outputs with \fBwlr-randr\fR or
with Sway using \fBswaymsg -t get_outputs\fR.\&
.PP
Example: \fIDP-1\fR
.PP
Default: Let the compositor choose output.\&
.PP
.RE
\fB-f\fR,\fB--font\fR=\fIFONT\fR[,\fIFALLBACK1\fR,\fIFALLBACK2\fR,.\&.\&.\&]
.RS 4
Comma separated list of primary font, and fallback fonts, in
FontConfig format.\& See \fBFONT FORMAT\fR.\& Default: \fImonospace\fR.\&
.PP
.RE
\fB--use-bold\fR
.RS 4
Allow fuzzel to use bold fonts.\&
.PP
.RE
\fB-D\fR,\fB--dpi-aware\fR=\fIno|yes|auto\fR
.RS 4
When set to \fByes\fR, fonts are sized using the monitor'\&s DPI, making
a font of a given point size have the same physical size,
regardless of monitor.\&
.PP
In this mode, the monitor'\&s scaling factor is ignored; doubling
the scaling factor will \fBnot\fR double the font size.\&
.PP
When set to \fBno\fR, the monitor'\&s DPI is ignored.\& The font is
instead sized using the monitor'\&s scaling factor; doubling the
scaling factor \fBdoes\fR double the font size.\&
.PP
Finally, if set to \fBauto\fR, fonts will be sized using the monitor'\&s
DPI if \fIall\fR monitors have a scaling factor of 1.\& If at least one
monitor as a scaling factor larger than 1 (regardless of whether
the fuzzel window is mapped on that monitor or not), fonts will be
scaled using the scaling factor.\&
.PP
Note that this option typically does not work with bitmap fonts,
which only contains a pre-defined set of sizes, and cannot be
dynamically scaled.\& Whichever size (of the available ones) that
best matches the DPI or scaling factor, will be used.\&
.PP
Also note that if the font size has been specified in pixels
(\fB:pixelsize=\fR\fIN\fR, instead of \fB:size=\fR\fIN\fR), DPI scaling
(\fBdpi-aware=yes\fR) will have no effect (the specified pixel size
will be used as is).\& But, if the monitor'\&s scaling factor is used
to size the font (\fBdpi-aware=no\fR), the font'\&s pixel size will be
multiplied with the scaling factor.\&
.PP
Default: \fIauto\fR
.PP
.RE
\fB--gamma-correct\fR
.RS 4
Do gamma-correct blending in linear color space.\& This is how font
glyphs are supposed to be rendered, but since nearly no
applications or toolkits are doing it on Linux, the result may not
look like you are used to.\&
.PP
Compared to the default (disabled), bright glyphs on a dark
background will appear thicker, and dark glyphs on a light
background will appear thinner.\&
.PP
FreeType can limit the effect of the latter, with a technique
called stem darkening.\& It is only available for CFF fonts
(OpenType, .\&otf) and disabled by default (in FreeType).\& You can
enable it by setting the environment variable
\fBFREETYPE_PROPERTIES="cff:no-stem-darkening=0"\fR before starting
fuzzel.\&
.PP
Also be aware that many fonts have been developed on systems that
do not do gamma-correct blending, and may therefore look thicker
than intended when rendered with gamma-correct blending, since the
font designer set the font weight based on incorrect rendering.\&
.PP
In order to represent colors faithfully, higher precision image
buffers are required.\& For this reason, fuzzel uses 16-bit image
buffers (instead of 8-bit) when gamma-correct blending is enabled.\&
.PP
It is not possible to enable gamma-correct blending in cairo
enabled builds of fuzzel, since cairo does not support 16-bit
image buffers.\&
.PP
.RE
\fB-p\fR,\fB--prompt\fR=\fIPROMPT\fR
.RS 4
Prompt to use.\& Default: \fI> \fR.\&
.PP
.RE
\fB--prompt-only\fR=\fIPROMPT\fR
.RS 4
Same as \fB--prompt\fR, but in \fB--dmenu\fR mode it also:
.PD 0
.IP \(bu 4
does not read anything from STDIN
.IP \(bu 4
sets \fB--lines\fR to 0
.PD
.PP
In non-dmenu mode it behaves exactly like \fB--prompt\fR.\&
.PP
.RE
\fB--hide-prompt\fR
.RS 4
Hide the prompt line, making the window smaller.\& Input is still
accepted, but the prompt line is not displayed.\& This option
cannot be used at the same time with \fB--prompt-only\fR.\&
.PP
.RE
\fB--placeholder\fR=\fITEXT\fR
.RS 4
Text to display as placeholder in the input box.\& Default: empty.\&
.PP
.RE
\fB--search\fR=\fITEXT\fR
.RS 4
Initial search/filter string.\& This option pre-fills the input box
with the specified string, letting you pre-filter the result.\&
.PP
.RE
\fB-i\fR
.RS 4
Ignored; for compatibility with other, similar utilities (where
\fB-i\fR means "case insensitive search").\&
.PP
.RE
\fB--icon-theme\fR=\fINAME\fR
.RS 4
Icon theme to use.\& Note that this option is case sensitive; the
name must match the theme'\&s folder name.\&
.PP
Example: \fIAdwaita\fR.\&
.PP
Default: \fIdefault\fR.\&
.PP
.RE
\fB-I\fR,\fB--no-icons\fR
.RS 4
Do not render any icons.\&
.PP
.RE
\fB--hide-before-typing\fR
.RS 4
Hide application list until something is typed.\&
.PP
.RE
\fB-F\fR,\fB--fields\fR=\fIFIELDS\fR
.RS 4
Comma separated list of XDG Desktop entry fields to match against:
.PP
.PD 0
.IP \(bu 4
\fBfilename\fR: the .\&desktop file'\&s filename
.IP \(bu 4
\fBname\fR: the application'\&s name (title)
.IP \(bu 4
\fBgeneric\fR: the application'\&s generic name
.IP \(bu 4
\fBexec\fR: the applications'\&s executable, as specified in the desktop
file.\& Note: may include command line options as well.\&
.IP \(bu 4
\fBkeywords\fR: the application'\&s keywords
.IP \(bu 4
\fBcategories\fR: the application'\&s categories
.IP \(bu 4
\fBcomment\fR: the application'\&s comment
.PD
.PP
Default: \fIfilename,name,generic\fR
.PP
.RE
\fB--password\fR=[\fICHARACTER\fR]
.RS 4
Password input.\& Render all typed text as \fICHARACTER\fR.\& If
\fICHARACTER\fR is omitted, a \fB*\fR will be used.\&
.PP
.RE
\fB-T\fR,\fB--terminal\fR=\fITERMINAL ARGS\fR
.RS 4
Command to launch XDG applications with the property
\fBTerminal=true\fR (\fIhtop\fR, for example).\&
.PP
The command may contain the placeholder \fI{cmd}\fR which will be
replaced with the actual command to be run.\& When \fI{cmd}\fR is present,
the command is \fB\fRonly\fB\fR substituted in those locations and is \fB\fRnot\fB\fR
appended at the end.\&
.PP
Examples:
.PD 0
.IP \(bu 4
\fIfoot -a '\&{cmd}'\& -T '\&{cmd}'\& {cmd}\fR sets app-id and title to the
command name, then executes it
.IP \(bu 4
\fIxterm -e {cmd}\fR executes the command in xterm
.IP \(bu 4
\fIxterm -e\fR (no {cmd}) uses old behavior: appends command after
terminal args
.PD
.PP
Default: \fInot set\fR.\&
.PP
.RE
\fB-a\fR,\fB--anchor\fR=\fIANCHOR\fR
.RS 4
Set window anchor, i.\&e.\& where on screen the window will be
displayed.\&  You can choose one from:
.PP
.PD 0
.IP \(bu 4
top-left
.IP \(bu 4
top
.IP \(bu 4
top-right
.IP \(bu 4
left
.IP \(bu 4
center
.IP \(bu 4
right
.IP \(bu 4
bottom-left
.IP \(bu 4
bottom
.IP \(bu 4
bottom-right
.PD
.PP
Default: \fIcenter\fR
.PP
.RE
\fB--x-margin\fR=\fIMARGIN\fR
.RS 4
Horizontal margin away from the anchor point in pixels.\& Default: \fI0\fR.\&
.PP
Note: this option has no effect when anchor=center, top or bottom.\&
.PP
.RE
\fB--y-margin\fR=\fIMARGIN\fR
.RS 4
Vertical margin away from the anchor point in pixels.\& Default: \fI0\fR.\&
.PP
Note: this option has no effect when anchor=center, left or right.\&
.PP
.RE
\fB--select\fR=\fISTRING\fR
.RS 4
Select the first entry that matches the given string (case
insensitive).\&
.PP
.RE
\fB--auto-select\fR
.RS 4
Automatically select when only one match remains.\&
.PP
.RE
\fB--select-index\fR=INDEX
.RS 4
Select the entry with index, not compatible with --select.\&
.PP
.RE
\fB-l\fR,\fB--lines\fR=COUNT
.RS 4
The (maximum) number of matches to display.\& This dictates the
window height.\& Default: \fI15\fR.\&
.PP
.RE
\fB--minimal-lines\fR
.RS 4
Adjust the number of lines to display to the minimum of \fI--lines\fR and
the number of input lines.\& Only effective in dmenu mode.\& This allows
fuzzel to size itself to the actual number of input lines rather than
always showing the full \fI--lines\fR rows.\&
.PP
.RE
\fB-w\fR,\fB--width\fR
.RS 4
Window width, in characters.\& Margins and borders not included.\& For
variable width fonts this is an estimate, as the exact number of
characters that will fit depends on which characters are being
displayed.\& Default: \fI30\fR.\&
.PP
.RE
\fB--tabs\fR=\fICOUNT\fR
.RS 4
Number of spaces a tab is expanded to.\& Default: \fI8\fR.\&
.PP
.RE
\fB-x\fR,\fB--horizontal-pad\fR=\fIPAD\fR
.RS 4
Horizontal padding between border and icons and text.\& In pixels,
subject to output scaling.\& Default: \fI40\fR.\&
.PP
.RE
\fB-y\fR,\fB--vertical-pad\fR=\fIPAD\fR
.RS 4
Vertical padding between border and text.\& In pixels, subject to
output scaling.\& Default: \fI8\fR.\&
.PP
.RE
\fB-P\fR,\fB--inner-pad\fR=\fIPAD\fR
.RS 4
Vertical padding between prompt and match list.\& In pixels, subject to
output scaling.\& Default: \fI0\fR.\&
.PP
.RE
\fB-b\fR,\fB--background\fR=\fIHEX\fR
.RS 4
Background color.\& See \fBCOLORS\fR.\& Default: \fIfdf6e3ff\fR.\&
.PP
.RE
\fB-t\fR,\fB--text-color\fR=\fIHEX\fR
.RS 4
Text color.\& See \fBCOLORS\fR.\& Default: \fI657b83ff\fR.\&
.PP
.RE
\fB--prompt-color\fR=\fIHEX\fR
.RS 4
Text (foreground) color of prompt character(s).\& See
\fBCOLORS\fR.\& Default: \fI586e75ff\fR.\&
.PP
.RE
\fB--placeholder-color\fR=\fIHEX\fR
.RS 4
Text (foreground) color of the placeholder string.\& See
\fBCOLORS\fR.\& Default: \fI93a1a1ff\fR.\&
.PP
.RE
\fB--input-color\fR=\fIHEX\fR
.RS 4
Text (foreground) color of input string.\& See \fBCOLORS\fR.\& Default:
\fI657b83ff\fR.\&
.PP
.RE
\fB-m\fR,\fB--match-color\fR=\fIHEX\fR
.RS 4
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 \fBCOLORS\fR.\& Default: \fIcb4b16ff\fR.\&
.PP
.RE
\fB-s\fR,\fB--selection-color\fR=\fIHEX\fR
.RS 4
The color to use as background of the currently selected
application.\& See \fBCOLORS\fR.\& Default: \fIeee8d5ff\fR.\&
.PP
.RE
\fB-S\fR,\fB--selection-text-color\fR=\fIHEX\fR
.RS 4
The text color of the currently selected application.\& See
\fBCOLORS\fR.\& Default: \fI586e75ff\fR.\&
.PP
.RE
\fB-M\fR,\fB--selection-match-color\fR=\fIHEX\fR
.RS 4
The color of matching substring(s) of the currently selected
application.\& As you start typing in the search box, the matching
part in each application'\&s name is highlighted with this color.\&
See \fBCOLORS\fR.\& Default: \fIcb4b16ff\fR.\&
.PP
.RE
\fB--selection-radius\fR=\fIINT\fR
.RS 4
The border radius of the selection entry.\& Like border-radius, this is
subjected to output scaling.\& A larger value means a rounder corner.\& 0
disables rounded corner.\& Default: \fI0\fR.\&
.PP
.RE
\fB--counter-color\fR=\fIHEX\fR
.RS 4
The color of the match count stats printed at the right-hand side
of the input prompt.\& See \fBCOLORS\fR.\& Default: \fI93a1a1ff\fR.\&
.PP
.RE
\fB-B\fR,\fB--border-width\fR=\fIINT\fR
.RS 4
The width of the surrounding border, in pixels (subject to output
scaling).\& Default: \fI1\fR.\&
.PP
.RE
\fB-r\fR,\fB--border-radius\fR=\fIINT\fR
.RS 4
The corner curvature, subject to output scaling.\& Larger means more
rounded corners.\& 0 disables rounded corners.\& Default: \fI10\fR.\&
.PP
.RE
\fB-C\fR,\fB--border-color\fR=\fIHEX\fR
.RS 4
The color of the border.\& See \fBCOLORS\fR.\& Default: \fI002b36ff\fR.\&
.PP
.RE
\fB--show-actions\fR
.RS 4
Include desktop actions in the list.\& Desktop actions are
alternative actions some desktop entries have.\& Examples include
"New Window", "New Document", etc.\&
.PP
.RE
\fB--match-mode\fR=\fIexact\fR|\fIfzf\fR|\fIfuzzy\fR
.RS 4
Defines how what you type is matched.\& See \fBfuzzel.\&ini\fR(5) for
details.\& The default is \fBfzf\fR.\&
.PP
.RE
\fB--no-sort\fR
.RS 4
Do not sort the result.\&
.PP
.RE
\fB--counter\fR
.RS 4
Display the match count.\&
.PP
.RE
\fB--filter-desktop\fR=[\fIno\fR]
.RS 4
Filter the visible desktop entries based on the value of
XDG_CURRENT_DESKTOP.\& If the optional parameter is "no", explicitly
disables filtering (that is, it overrides the value in the
config).\&
.PP
.RE
\fB--fuzzy-min-length\fR=\fIVALUE\fR
.RS 4
Search strings shorter than this will not by fuzzy
matched.\& Default: \fI3\fR.\&
.PP
.RE
\fB--fuzzy-max-length-discrepancy\fR=\fIVALUE\fR
.RS 4
Maximum allowed length difference between the search string, and a
fuzzy match.\& Larger values result in more fuzzy matches.\& Default:
\fI2\fR.\&
.PP
.RE
\fB--fuzzy-max-distance\fR=\fIVALUE\fR
.RS 4
Maximum allowed levenshtein distance between the search string,
and a fuzzy match.\& Larger values result in more fuzzy
matches.\& Default: \fI1\fR.\&
.PP
.RE
\fB--line-height\fR=\fIHEIGHT\fR
.RS 4
Override line height from font metrics.\& In points by default, but
can be specified as pixels by appending '\&px'\&
(i.\&e.\& \fB--line-height=16px\fR).\& Default: \fInot set\fR.\&
.PP
.RE
\fB--letter-spacing\fR=\fIAMOUNT\fR
.RS 4
Additional space between letters.\& In points by default, but can be
specified as pixels by appending '\&px'\&
(i.\&e.\& \fBletter-spacing=5px\fR).\& Negative values are
supported.\& Default: \fI0\fR.\&
.PP
.RE
\fB--layer\fR=\fItop\fR|\fIoverlay\fR
.RS 4
Which layer to render the fuzzel window on.\& Valid values are \fBtop\fR
and \fBoverlay\fR.\&
.PP
\fBtop\fR renders above normal windows, but typically below fullscreen
windows and lock screens.\&
.PP
\fBoverlay\fR renders on top of both normal windows and fullscreen
windows.\& Note that the order is undefined if several windows use
the same layer.\& Since e.\&g.\& lock screens typically use \fBoverlay\fR,
that means fuzzel may or may not appear on top of a lock screen.\&
.PP
Default: \fIoverlay\fR
.PP
.RE
\fB--keyboard-focus\fR=\fIexclusive\fR|\fIon-demand\fR
.RS 4
Keyboard focusing mode, valid modes are \fBexclusive\fR and \fBon-demand\fR.\&
.PP
\fBexclusive\fR locks keyboard focus to fuzzel, receiving all keyboard
input until closed.\&
.PP
\fBon-demand\fR makes fuzzel focus like a regular window, allowing other
windows to take keyboard focus by e.\&g.\& clicking on them.\&
By default switching keyboard focus will immediately close fuzzel,
using \fB--no-exit-on-keyboard-focus-loss\fR allows interacting with
other windows while fuzzel is open.\&
.PP
Default: \fIexclusive\fR
.PP
.RE
\fB--no-exit-on-keyboard-focus-loss\fR
.RS 4
Do not exit when losing keyboard focus.\& This can be useful on
compositors where enabling "focus-follows-mouse" causes fuzzel to
exit as soon as the mouse is moved over another window.\& Sway (at
least up to, and including 1.\&7) exhibits this behavior.\&
.PP
.RE
\fB--launch-prefix\fR=\fICOMMAND\fR
.RS 4
Command to launch XDG applications with.\&
If set, fuzzel will pass the Desktop File ID of the chosen application
(see the Desktop Entry specification) in the FUZZEL_DESKTOP_FILE_ID
environment variables.\& Default: \fInot set\fR.\&
.PP
.RE
\fB--list-executables-in-path\fR
.RS 4
Include executables from the PATH environment variable.\& Applies to
the normal application mode, not the dmenu mode.\&
.PP
.RE
\fB--render-workers\fR=\fICOUNT\fR
.RS 4
Number of threads to use for rendering.\& Set to 0 to disable
multithreading.\& Default: the number of available logical CPUs
(including SMT).\& Note that this is not always the best value.\& In
some cases, the number of physical \fIcores\fR is better.\&
.PP
.RE
\fB--match-workers\fR=\fICOUNT\fR
.RS 4
Number of threads to use for matching.\& Set to 0 to disable
multithreading.\& Default: the number of available logical CPUs
(including SMT).\& Note that this is not always the best value.\& In
some cases, the number of physical \fIcores\fR is better.\&
.PP
.RE
\fB--delayed-filter-ms\fR=\fITIME_MS\fR
.RS 4
Time, in milliseconds, to delay refiltering when there are more
matches than \fB--delayed-filter-limit\fR.\& Default: \fI300\fR.\&
.PP
.RE
\fB--delayed-filter-limit\fR=\fIN\fR
.RS 4
When there are more matches than this, switch from immediate
refiltering to delayed refiltering (see
\fB--delayed-filter-ms\fR).\& Default: \fI20000\fR.\&
.PP
.RE
\fB--scaling-filter\fR=\fIFILTER\fR
.RS 4
Scaling filter to use when down scaling PNGs.\& One of \fBnone\fR,
\fBnearest\fR, \fBbilinear\fR, \fBbox\fR, \fBlinear\fR, \fBcubic\fR, \fBlanczos2\fR,
\fBlanczos3\fR and \fBlanczos3-stretched\fR.\&
.PP
\fBnone\fR, \fBnearest\fR and \fBbilinear\fR are the fastest options, but also
have the worst looking results.\&
.PP
\fBcubic\fR, \fBlanczos2\fR, \fBlanczos3\fR and \fBlanczos3-stretched\fR are the
slowest options, with the best looking results.\&
.PP
\fBbox\fR, and to some degree, \fBlinear\fR, are in the middle,
performance wise, while in most cases still being just as, or
close to, as good as \fBcubic\fR and the lanczos filters.\&
.PP
Default: \fIbox\fR
.PP
.RE
\fB-d\fR,\fB--dmenu\fR
.RS 4
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.\&
.PP
Alternatively, you can symlink the fuzzel binary to
\fBdmenu\fR.\& Fuzzel will then start in dmenu mode, without the
\fB--dmenu\fR argument.\&
.PP
Fuzzel also supports PNG and SVG icons, using Rofi'\&s extended dmenu
protocol.\& To set an icon for an entry, append
\fB\e0icon\ex1f<icon-name>\fR.\& Example:
.PP
.RS 4
echo -en "Firefox\e0icon\ex1ffirefox" | fuzzel --dmenu
.PP
.RE
Fallback icons using comma-separated values are also supported.\&
When the primary icon is not found, subsequent icons in the
list will be tried until one is successfully loaded.\& Example:
.PP
.RS 4
echo -en "Firefox\e0icon\ex1ffirefox,web-browser,application-x-executable" | fuzzel --dmenu
.PP
.RE
.RE
\fB--dmenu0\fR
.RS 4
Like \fB--dmenu\fR, but input is NUL separated instead of newline
separated.\& Note that in this mode, icons are not supported.\&
.PP
.RE
\fB--index\fR
.RS 4
Print selected entry'\&s index instead of its text.\&
Index values start with zero for the first entry.\&
dmenu mode only.\&
.PP
.RE
\fB--with-nth\fR=\fIN\fR|\fIFMT\fR
.RS 4
Display the N:th column (1-based, tab separated by default, see
\fB--nth-delimiter\fR) of each input line.\& When selected, the full
input line is printed on stdout.\& dmenu mode only.\&
.PP
The argument can also be a format string (i.\&e free-format text),
where \fB{N}\fR expands to the N:th column.\& Ranges on the form
\fB{N.\&.\&M}\fR and \fB{N.\&.\&}\fR (open-ended) are also supported.\&
.PP
Example:
.nf
.RS 4
printf "1\\tFirst\\n2\\tSecond" | fuzzel -d --with-nth=2
.fi
.RE
.PP
This will display the entries \fBFirst\fR and \fBSecond\fR.\& When one of
them is selected, the full input line (tabs included) are printed
on stdout.\&
.PP
Setting it to \fB0\fR is the same as not specifying \fB--with-nth\fR at
all.\&
.PP
.RE
\fB--accept-nth\fR=\fIN\fR|\fIFMT\fR
.RS 4
Output the N:th column (1-based, tab separated by default, see
\fB--nth-delimiter\fR) of each input line to stdout.\&  dmenu mode only.\&
.PP
The argument can also be a format string (i.\&e free-format text),
where \fB{N}\fR expands to the N:th column.\& Ranges on the form
\fB{N.\&.\&M}\fR and \fB{N.\&.\&}\fR (open-ended) are also supported.\&
.PP
Example:
.nf
.RS 4
printf "1\\tFirst\\n2\\tSecond" | fuzzel -d --accept-nth=2
.fi
.RE
.PP
This will display the entries \fB1 First\fR and \fB2 Second\fR.\& Depending
on which one is selected, \fBFirst\fR or \fBSecond\fR will be printed to
stdout.\&
.PP
Setting it to \fB0\fR is the same as not specifying \fB--accept-nth\fR at
all.\&
.PP
.RE
\fB--match-nth\fR=\fIN\fR|\fIFMT\fR
.RS 4
Match against the N:th column (1-based, tab separated by default,
see \fB--nth-delimiter\fR) of each input line.\& This is instead of
matching against the displayed value (which can be changed with
\fB--with-nth\fR).\&
.PP
The argument can also be a format string (i.\&e free-format text),
where \fB{N}\fR expands to the N:th column.\& Ranges on the form
\fB{N.\&.\&M}\fR and \fB{N.\&.\&}\fR (open-ended) are also supported.\&
.PP
Example:
.nf
.RS 4
printf "123t456t789" | fuzzel -d --with-nth=1 --accept-nth=2 --match-nth=3
.fi
.RE
.PP
This will display the entry \fB123\fR, but matching will \fBonly\fR be
done against \fB789\fR (specifically, \fB123\fR will not match).\& When
selected, \fB456\fR is printed on stdout.\&
.PP
Setting it to \fB0\fR is the same as not specifying \fB--match-nth\fR at
all.\&
.PP
.RE
\fB--nth-delimiter\fR=\fICHARACTER\fR
.RS 4
Field (column) delimiter for \fB--with-nth\fR and \fB--accept-nth\fR.\& Must
be a single ASCII character.\&
.PP
Default: \fI\et\fR (tab)
.PP
.RE
\fB--only-match\fR
.RS 4
Do not allow custom entries, only return a selected item.\& In this
mode, fuzzel always returns an entry.\& It will not return if no
matching entry is selected.\&
.PP
The exception to this is the \fBexecute-input\fR key binding, which
always executes/selects the input text.\&
.PP
.RE
\fB-R\fR,\fB--no-run-if-empty\fR
.RS 4
Exit immediately, without showing the UI, if stdin is
empty.\& dmenu mode only.\&
.PP
.RE
\fB--log-level\fR={\fBinfo\fR,\fBwarning\fR,\fBerror\fR,\fBnone\fR}
.RS 4
Log level, used both for log output on stderr as well as
syslog.\& Default: \fIwarning\fR.\&
.PP
.RE
\fB--log-colorize\fR=[{\fBnever\fR,\fBalways\fR,\fBauto\fR}]
.RS 4
Enables or disables colorization of log output on stderr.\&
.PP
.RE
\fB--log-no-syslog\fR
.RS 4
Disables syslog logging.\& Logging is only done on stderr.\&
.PP
.RE
\fB--print-timing-info\fR
.RS 4
Print timing information to help debug performance issues.\&
.PP
.RE
\fB--no-mouse\fR
.RS 4
Disable mouse input.\&
.PP
.RE
\fB-v\fR,\fB--version\fR
.RS 4
Show the version number and quit
.PP
.RE
.SH SEARCH PATHS
.PP
Fuzzel searches for XDG \fB.\&desktop\fR files according to the XDG Base
Directory Specification (see link at bottom), looking in the
\fBapplications\fR subdirectory of the paths given by \fBXDG_DATA_DIRS\fR and
\fBXDG_DATA_HOME\fR.\& By default, these are:
.PP
.PD 0
.IP \(bu 4
\fB\(ti/.\&local/share/applications\fR
.IP \(bu 4
\fB/usr/local/share/applitions\fR
.IP \(bu 4
\fB/usr/share/application\fR
.PD
.PP
See the specification for details.\&
.PP
.SH CONFIGURATION
.PP
fuzzel will search for a configuration file in the following locations,
in this order:
.PP
.RS 4
.PD 0
.IP \(bu 4
\fBXDG_CONFIG_HOME/fuzzel/fuzzel.\&ini\fR (defaulting to
\fB\(ti/.\&config/fuzzel/fuzzel.\&ini\fR if unset)
.IP \(bu 4
\fBXDG_CONFIG_DIRS/fuzzel/fuzzel.\&ini\fR (defaulting to
\fB/etc/xdg/fuzzel/fuzzel.\&ini\fR if unset)
.PD
.PP
.RE
An example configuration file containing all options with their default value
commented out will usually be installed to \fB/etc/xdg/fuzzel/fuzzel.\&ini\fR.\&
.PP
For more information, see \fBfuzzel.\&ini\fR(5).\&
.PP
.SH LOCALIZATION
.PP
Fuzzel uses the localized strings from the .\&desktop files by
default.\& To disable this, run fuzzel with \fBLC_MESSAGES=C\fR.\&
.PP
.SH FONT FORMAT
.PP
The font is specified in FontConfig syntax.\& That is, a colon-separated
list of font name and font options.\&
.PP
\fIExamples\fR:
.PD 0
.IP \(bu 4
Dina:weight=bold:slant=italic
.IP \(bu 4
Arial:size=12
.PD
.PP
.PP
.SH COLORS
.PP
All colors must be specified as a RGBA quadruple, in hex format,
without a leading '\&0x'\&.\&
.PP
\fIEXAMPLES\fR:
.PD 0
.IP \(bu 4
white: \fBffffffff\fR (no transparency)
.IP \(bu 4
black: \fB000000ff\fR (no transparency)
.IP \(bu 4
black: \fB00000010\fR (semi-transparent)
.IP \(bu 4
red: \fBff0000ff\fR (no transparency)
.PD
.PP
The default color scheme is \fISolarized\fR.\&
.PP
.SH FILES
.PP
\fI$XDG_CACHE_HOME/fuzzel\fR
.RS 4
Stores a list of applications and their launch count.\& This allows
fuzzel to sort frequently launched applications at the top.\&
.PP
.RE
\fI$XDG_RUNTIME_DIR/fuzzel-$WAYLAND_DISPLAY.\&lock\fR
.RS 4
Lock file, used to prevent multiple fuzzel instances from running
at the same time.\&
.PP
.RE
.SH SEE ALSO
.PP
.PD 0
.IP \(bu 4
\fBfuzzel.\&ini\fR(5)
.IP \(bu 4
\fBhttps://specifications.\&freedesktop.\&org/desktop-entry-spec/desktop-entry-spec-latest.\&html\fR
.IP \(bu 4
\fBhttps://codeberg.\&org/dnkl/fuzzel\fR
.IP \(bu 4
\fBhttps://specifications.\&freedesktop.\&org/basedir-spec/latest/\fR