1fuzzel.ini(5) File Formats Manual fuzzel.ini(5)
2
6 fuzzel.ini - configuration file for fuzzel(1)
7
9 fuzzel uses the standard unix configuration format, with section based
10 key/value pairs. The default section is usually unnamed, i.e. not pre‐
11 fixed with a [section]. However it can also be explicitly named [main],
12 say if it needs to be reopened after any of the other sections.
13 fuzzel will search for a configuration file in the following locations,
15 in this order:
16 • XDG_CONFIG_HOME/fuzzel/fuzzel.ini (defaulting to ~/.con‐
18 fig/fuzzel/fuzzel.ini if unset)
19 • XDG_CONFIG_DIRS/fuzzel/fuzzel.ini (defaulting to
20 /etc/xdg/fuzzel/fuzzel.ini if unset)
21 An example configuration file containing all options with their default
24 value commented out will usually be installed to
25 /etc/xdg/fuzzel/fuzzel.ini.
26
28 output
29 Output (monitor) to display on. You can list the available outputs
30 with wlr-randr or with Sway using swaymsg -t get_outputs.
31 Example: DP-1
33 Default: Not set-- let the compositor choose output.
35 font
37 Comma separated list of fonts to use, in fontconfig format. That
38 is, a font name followed by a list of colon-separated options. Most
39 noteworthy is :size=n, which is used to set the font size. Note
40 that the font size is also affected by the dpi-aware option.
41 Examples:
43 • Dina:weight=bold:slant=italic
44 • Courier New:size=12
45 • Fantasque Sans Mono:fontfeatures=ss01
46 Default: monospace.
49 dpi-aware
51 auto, yes, or no.
52 When set to yes, fonts are sized using the monitor's DPI, making a
54 font of a given size have the same physical size, regardless of
55 monitor.
56 In this mode, the monitor's scaling factor is ignored; doubling the
58 scaling factor will not double the font size.
59 When set to no, the monitor's DPI is ignored. The font is instead
61 sized using the monitor's scaling factor; doubling the scaling fac‐
62 tor does double the font size.
63 Finally, if set to auto, fonts will be sized using the monitor's
65 DPI if all monitors have a scaling factor of 1. If at least one
66 monitor as a scaling factor larger than 1 (regardless of whether
67 the fuzzel window is mapped on that monitor or not), fonts will be
68 scaled using the scaling factor.
69 Note that this option typically does not work with bitmap fonts,
71 which only contains a pre-defined set of sizes, and cannot be dy‐
72 namically scaled. Whichever size (of the available ones) that best
73 matches the DPI or scaling factor, will be used.
74 Also note that if the font size has been specified in pixels (:pix‐
76 elsize=N, instead of :size=N), DPI scaling (dpi-aware=yes) will
77 have no effect (the specified pixel size will be used as is). But,
78 if the monitor's scaling factor is used to size the font (dpi-
79 aware=no), the font's pixel size will be multiplied with the scal‐
80 ing factor.
81 Default: auto.
83 prompt=
85 String to use as input prompt. Note that trailing spaces are
86 trimmed, unless the string is quoted. Default: "> ".
87 icon-theme
89 Icon theme. Note that the name is case sensitive. Default: hicolor.
90 icons-enabled
92 Boolean. When enabled, application icons (from the selected icon-
93 theme) will be rendered. Default: yes.
94 fields
96 Comma separated list of XDG Desktop entry fields to match against.
97 Even though fuzzel only displays the application names, matching
99 can (and by default is) be done against other fields as well. Sup‐
100 ported fields are:
101 • filename
103 • name
104 • generic
105 • exec
106 • categories
107 • keywords
108 • comment
109 Default: filename,name,generic.
112 password-character
114 Default character to use with the command line option --password.
115 Note that this can be overridden on the command line, by explicitly
116 specifying the character with --password=X. Default: *.
117 filter-desktop
119 Boolean. Filter desktop files based on the value of XDG_CUR‐
120 RENT_DESKTOP.
121 fuzzy
123 Boolean. Enables or disables fuzzy matching. Default: yes.
124 show-actions
126 Boolean. Some desktop files define "actions", in addition to the
127 application itself. Examples are "new window", "preferences", etc.
128 When this option is enabled, those actions will be listed by
129 fuzzel. Default: no.
130 terminal
132 terminal command to use when launching 'terminal' programs, e.g.
133 "xterm -e". Default: $TERMINAL -e.
134 launch-prefix
136 Prefix to add before argv of executed program. If set, fuzzel will
137 pass the Desktop File ID of the chosen application (see the Desktop
138 Entry specification) in the FUZZEL_DESKTOP_FILE_ID environment
139 variables. Default: not set.
140 lines
142 Number of matches to show. Default: 15.
143 width
145 Window width, in characters. Border and margins are not included in
146 this. Default: 30.
147 tabs
149 Number of spaces a tab is expanded to. Default: 8.
150 horizontal-pad
152 Horizontal padding, in pixels, between border and content. Default:
153 40.
154 vertical-pad
156 Vertical padding, in pixels, between border and content. Default:
157 8.
158 inner-pad
160 Vertical padding between prompt and match list, in pixels. Default:
161 0.
162 image-size-ratio
164 The ratio of the large image displayed when there are only a "few"
165 matches, compared to the full window size. Default: 0.5.
166 line-height
168 Override line height from font metrics. Default: use font metrics.
169 letter-spacing
171 Additional letter spacing. Negative values are allowed. Default: 0.
172 layer
174 Which layer to render the fuzzel window on. Valid values are top
175 and overlay.
176 top renders above normal windows, but typically below fullscreen
178 windows and lock screens.
179 overlay renders on top of both normal windows and fullscreen win‐
181 dows. Note that the order is undefined if several windows use the
182 same layer. Since e.g. lock screens typically use overlay, that
183 means fuzzel may or may not appear on top of a lock screen.
184 Default: top
186 exit-on-keyboard-focus-loss
188 Boolean. If true, exit when the fuzzel window loses keyboard focus.
189 Setting this to false can be useful on compositors where enabling
191 "focus-follows-mouse" causes fuzzel to exit as soon as the mouse is
192 moved over another window. Sway (<= 1.7) exhibits this behavior,
193 for example.
194 Default: yes
196
198 All color values are in RGBA.
199 background
201 Background color. Default: fdf6e3dd.
202 text
204 Text (foreground) color of unselected entries. Default: 657b83ff.
205 match
207 Text (foreground) color of the matched substring. Default:
208 cb4b16ff.
209 selection
211 Background color of the selected entry. Default: eee8d5dd.
212 selection-text
214 Text (foreground) color of the selected entry. Default: 657b83ff.
215 selection-match
217 Text (foreground) color of the matched substring of the selected
218 entry. Default: cb4b16ff.
219 border
221 Border color. Default: 002b36ff.
222
224 width
225 Width of the border, in pixels. Default: 1.
226 radius
228 Amount of corner "roundness". Default: 10.
229
231 mode
232 One of text or index. Determines what fuzzel prints on stdout when
233 an entry is selected: text prints the entry itself, index prints
234 the index of the selected entry. Default: text.
235 exit-immediately-if-empty
237 Boolean. If enabled, fuzzel will not run at all (i.e. it will not
238 open a window, and will not print anything on stdout) if there's
239 nothing on stdin. Default: no.
240
242 This section lets you override the default key bindings.
243 The general format is action=combo1...comboN. That is, each action may
245 have one or more key combinations, space separated. Each combination is
246 in the form mod1+mod2+key. The names of the modifiers and the key must
247 be valid XKB key names.
248 Note that if Shift is one of the modifiers, the key must not be in up‐
250 per case. For example, Control+Shift+V will never trigger, but Con‐
251 trol+Shift+v will.
252 Note that Alt is usually called Mod1.
254 xkbcli interactive-wayland can be useful for finding keysym names.
256 A key combination can only be mapped to one action. Lets say you want
258 to bind Control+k to next. Since this is the default shortcut for
259 delete-line, you must unmap the default binding. This can be done by
260 setting action=none; e.g. delete-line=none.
261 cancel
263 Quite fuzzel without executing anythingDefault: Control+g Control+c
264 Escape.
265 execute
267 Execute the currently selected entry. Or, in dmenu mode, print the
268 selected entry on stdout. Default: Return KP_Enter Control+y.
269 execute-or-next
271 If there is a single match, execute it. If there are more than one
272 match, select the next entry. Wraps around when the last entry has
273 been reached. Default: Tab.
274 cursor-left
276 Moves the cursor one character to the left. Default: Left Con‐
277 trol+b.
278 cursor-left-word
280 Moves the cursor one word to the left. Default: Control+Left
281 Mod1+b.
282 cursor-right
284 Moves the cursor one character to the right. Default: Right Con‐
285 trol+f.
286 cursor-right-word
288 Moves the cursor one word to the right. Default: Control+Right
289 Mod1+f.
290 cursor-home
292 Moves the cursor to the beginning of the input. Default: Home Con‐
293 trol+a.
294 cursor-end
296 Moves the cursor to the end of the input. Default: End Control+e.
297 delete-prev
299 Deletes the character before the cursor. Default: BackSpace.
300 delete-prev-word
302 Deletes the word before the cursor. Default: Mod1+BackSpace Con‐
303 trol+BackSpace.
304 delete-next
306 Deletes the character after the cursor. Default: Delete.
307 delete-next-word
309 Deletes the word after the cursor. Default: Mod1+d Control+Delete.
310 delete-line
312 Deletes everything after the cursor. Default: Control+k.
313 insert-selected
315 Copies the selected entry to the prompt, replacing the current
316 prompt. In application mode, the Exec line is inserted, and in
317 dmenu mode the entry itself is used. Default: Control+Tab.
318 prev
320 Select the previous entry. Does not wrap around when the first en‐
321 try has been reached. Default: Up Control+p.
322 prev-with-wrap
324 Select the previous entry. Wraps around when the first entry has
325 been reached. Default: ISO_Left_Tab.
326 prev-page
328 Switch to the previous page. Default: PageUp KP_PageUp.
329 next
331 Select the next entry. Does not wrap around when the last entry has
332 been reached. Default: Down Control+n.
333 next-with-wrap
335 Select the previous entry. Wraps around when the first entry has
336 been reached. Default: not bound.
337 next-page
339 Switch to the next page. Default: Page_Down KP_Page_Down.
340 first
342 Select the first entry, on the first page. Default: Control+Home.
343 last
345 Select the last entry, on the last page. Default: Control+End.
346 custom-1, custom-2, ..., custom-19
348 Execute the currently selected entry, then exit with a non-zero
349 exit code. custom-1 exits with exit code 10, custom-2 with 11, cus‐
350 tom-3 with 12, and so on.
351 Default:
353 • custom-1: Mod1+1
354 • custom-2: Mod1+2
355 • custom-3: Mod1+3
356 • custom-4: Mod1+4
357 • custom-5: Mod1+5
358 • custom-6: Mod1+6
359 • custom-7: Mod1+7
360 • custom-8: Mod1+8
361 • custom-9: Mod1+9
362 • custom-10: Mod1+10
363 • custom-11: Mod1+11
364 • custom-12: Mod1+12
365 • custom-13: Mod1+13
366 • custom-14: Mod1+14
367 • custom-15: Mod1+15
368 • custom-16: Mod1+16
369 • custom-17: Mod1+17
370 • custom-18: Mod1+18
371 • custom-19: Mod1+19
372
375 fuzzel(1), https://specifications.freedesktop.org/desktop-entry-
376 spec/desktop-entry-spec-latest.html
377 2023-07-19 fuzzel.ini(5)