1fuzzel(1) General Commands Manual fuzzel(1)
2
6 fuzzel - display XDG applications in a searchable Wayland window
7
9 fuzzel [OPTIONS]...
10
12 fuzzel lists all available XDG applications in a searchable Window. The
13 search box supports Emacs-like key bindings.
14 The window size, font and colors can be configured with command line
16 options:
17 -o,--output=OUTPUT
19 Specifies the monitor to display the window on. In Sway, you can
20 list the available outputs with swaymsg -t get_outputs.
21 The default is to let the compositor choose output.
23 -f,--font=FONT[,FALLBACK1,FALLBACK2,...]
25 Comma separated list of primary font, and fallback fonts, in Font‐
26 Config format. See FONT FORMAT. Default: monospace.
27 -D,--dpi-aware=no|yes|auto
29 When set to yes, fonts are sized using the monitor's DPI, making a
30 font of a given point size have the same physical size, regardless
31 of monitor.
32 In this mode, the monitor's scaling factor is ignored; doubling the
34 scaling factor will not double the font size.
35 When set to no, the monitor's DPI is ignored. The font is instead
37 sized using the monitor's scaling factor; doubling the scaling fac‐
38 tor does double the font size.
39 Finally, if set to auto, fonts will be sized using the monitor's
41 DPI if all monitors have a scaling factor of 1. If at least one
42 monitor as a scaling factor larger than 1 (regardless of whether
43 the fuzzel window is mapped on that monitor or not), fonts will be
44 scaled using the scaling factor.
45 Note that this option typically does not work with bitmap fonts,
47 which only contains a pre-defined set of sizes, and cannot be dy‐
48 namically scaled. Whichever size (of the available ones) that best
49 matches the DPI or scaling factor, will be used.
50 Also note that if the font size has been specified in pixels (:pix‐
52 elsize=N, instead of :size=N), DPI scaling (dpi-aware=yes) will
53 have no effect (the specified pixel size will be used as is). But,
54 if the monitor's scaling factor is used to size the font (dpi-
55 aware=no), the font's pixel size will be multiplied with the scal‐
56 ing factor.
57 Default: auto
59 -P,--prompt=PROMPT
61 Prompt to use. Default: > .
62 -i,--icon-theme=NAME
64 Icon theme to use. Note that this option is case sensitive; the
65 name must match the theme's folder name.
66 Example: Adwaita.
68 Default: hicolor.
70 -I,--no-icons
72 Do not render any icons.
73 -F,--fields=FIELDS
75 Comma separated list of XDG Desktop entry fields to match against:
76 • filename: the .desktop file's filename
78 • name: the application's name (title)
79 • generic: the application's generic name
80 • exec: the applications's executable, as specified in the desk‐
81 top file. Note: may include command line options as well.
82 • keywords: the application's keywords
83 • categories: the application's categories
84 • comment: the application's comment
85 Default: filename,name,generic
88 -T,--terminal=TERMINAL ARGS
90 Command to launch XDG applications with the property Terminal=true
91 (htop, for example). Example: xterm -e. Default: not set.
92 -l,--lines=COUNT
94 The (maximum) number of matches to display. This dictates the win‐
95 dow height. Default: 15.
96 -w,--width
98 Window width, in characters. Margins and borders not included. De‐
99 fault: 30.
100 -x,--horizontal-pad=PAD
102 Horizontal padding between border and icons and text. In pixels,
103 subject to output scaling. Default: 40.
104 -y,--vertical-pad=PAD
106 Vertical padding between border and text. In pixels, subject to
107 output scaling. Default: 8.
108 -p,--inner-pad=PAD
110 Vertical padding between prompt and match list. In pixels, subject
111 to output scaling. Default: 0.
112 -b,--background=HEX
114 Background color. See COLORS. Default: fdf6e3dd.
115 -t,--text-color=HEX
117 Text color. See COLORS. Default: 657b83ff.
118 -m,--match-color=HEX
120 The color of matching substring(s). As you start typing in the
121 search box, the matching part in each application's name is high‐
122 lighted with this color. See COLORS. Default: cb4b16ff.
123 -s,--selection-color=HEX
125 The color to use as background of the currently selected applica‐
126 tion. See COLORS. Default: eee8d5dd.
127 -S,--selection-text-color=HEX
129 The text color of the currently selected application. See COLORS.
130 Default: 0x657b83ff.
131 -B,--border-width=INT
133 The width of the surrounding border, in pixels (subject to output
134 scaling). Default: 1.
135 -r,--border-radius=INT
137 The corner curvature. Larger means more rounded corners. 0 disables
138 rounded corners. Default: 10.
139 -C,--border-color=HEX
141 The color of the border. See COLORS. Default: 002b36ff.
142 --show-actions
144 Include desktop actions in the list. Desktop actions are alterna‐
145 tive actions some desktop entries have. Examples include "New Win‐
146 dow", "New Document", etc.
147 --no-fuzzy
149 Disables fuzzy matching. When disabled, only exact (case insensi‐
150 tive) substring matches are considered.
151 --fuzzy-min-length=VALUE
153 Search strings shorter than this will not by fuzzy matched. De‐
154 fault: 3.
155 --fuzzy-max-length-discrepancy=VALUE
157 Maximum allowed length difference between the search string, and a
158 fuzzy match. Larger values result in more fuzzy matches. Default:
159 2.
160 --fuzzy-max-distance=VALUE
162 Maximum allowed levenshtein distance between the search string, and
163 a fuzzy match. Larger values result in more fuzzy matches. Default:
164 1.
165 --line-height=HEIGHT
167 Override line height from font metrics. In points by default, but
168 can be specified as pixels by appending 'px' (i.e. --line-
169 height=16px). Default: not set.
170 --letter-spacing=AMOUNT
172 Additional space between letters. In points by default, but can be
173 specified as pixels by appending 'px' (i.e. letter-spacing=5px).
174 Negative values are supported. Default: 0.
175 --launch-prefix=COMMAND
177 Command to launch XDG applications with. Example: swaymsg exec --.
178 Default: not set.
179 -d,--dmenu
181 dmenu compatibility mode. In this mode, the list entries are read
182 from stdin (newline separated). The selected entry is printed to
183 stdout. If the input string does not match any of the entries, the
184 input string is printed as is on stdout.
185 --index
187 Print selected entry's index instead of its text. dmenu mode only.
188 -R,--no-run-if-empty
190 Exit immediately, without showing the UI, if stdin is empty. dmenu
191 mode only.
192 --log-level={info,warning,error,none}
194 Log level, used both for log output on stderr as well as syslog.
195 Default: info.
196 --log-colorize=[{never,always,auto}]
198 Enables or disables colorization of log output on stderr.
199 --log-no-syslog
201 Disables syslog logging. Logging is only done on stderr.
202 -v,--version
204 Show the version number and quit
205
207 The font is specified in FontConfig syntax. That is, a colon-separated
208 list of font name and font options.
209 Examples:
211 • Dina:weight=bold:slant=italic
212 • Arial:size=12
213
216 All colors must be specified as a RGBA quadruple, in hex format, with‐
217 out a leading '0x'.
218 EXAMPLES:
220 • white: ffffffff (no transparency)
221 • black: 000000ff (no transparency)
222 • black: 00000010 (semi-transparent)
223 • red: ff0000ff (no transparency)
224 The default color scheme is Solarized.
227
229 $XDG_CACHE_HOME/fuzzel
230 Stores a list of applications and their launch count. This allows
231 fuzzel to sort frequently launched applications at the top.
232 $XDG_RUNTIME_DIR/fuzzel-$WAYLAND_DISPLAY.lock
234 Lock file, used to prevent multiple fuzzel instances from running
235 at the same time.
236 2022-02-05 fuzzel(1)