.\" 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" "2024-04-15"
.PP
.SH NAME
fuzzel - display XDG applications in a searchable Wayland window
.PP
.SH SYNOPSIS
\fBfuzzel\fR [\fIOPTIONS\fR].\&.\&.\&
.PP
.SH DESCRIPTION
.PP
\fBfuzzel\fR lists all available XDG applications in a searchable
Window.\& The search box supports Emacs-like key bindings.\&
.PP
Fuzzel uses the localized strings from the .\&desktop files by
default.\& To disable this, run fuzzel with \fBLC_MESSAGES=C\fR.\&
.PP
The window size, font and colors 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-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-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-p\fR,\fB--prompt\fR=\fIPROMPT\fR
.RS 4
Prompt to use.\& Default: \fI> \fR.\&
.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: \fIhicolor\fR.\&
.PP
.RE
\fB-I\fR,\fB--no-icons\fR
.RS 4
Do not render any icons.\&
.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).\& Example: \fIxterm -e\fR.\&
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
\fBselect\fR=\fISTRING\fR
.RS 4
Select the first entry that matches the given string (case
insensitive).\&
.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-w\fR,\fB--width\fR
.RS 4
Window width, in characters.\& Margins and borders not
included.\& 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: \fIfdf6e3dd\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-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: \fIeee8d5dd\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: \fI657b83ff\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-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--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.\&
.PP
.RE
\fB--no-fuzzy\fR
.RS 4
Disables fuzzy matching.\& When disabled, only exact (case
insensitive) substring matches are considered.\&
.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: \fItop\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.\&  Example: \fIswaymsg exec --\fR.\&
Default: \fInot set\fR.\&
.PP
.RE
\fB--list-executables-in-path\fR
.RS 4
Include executables from the PATH environment variable.\&
.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 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
.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.\& \fB\fRdmenu\fB\fR mode
only.\&
.PP
.RE
\fB-R\fR,\fB--no-run-if-empty\fR
.RS 4
Exit immediately, without showing the UI, if stdin is
empty.\& \fB\fRdmenu\fB\fR 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-v\fR,\fB--version\fR
.RS 4
Show the version number and quit
.PP
.RE
.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~/.\&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 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