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. If unset, the compositor will
30 choose the monitor. Default: not set.
31 font
33 Comma separated list of fonts to use, in fontconfig format. That
34 is, a font name followed by a list of colon-separated options. Most
35 noteworthy is :size=n, which is used to set the font size. Note
36 that the font size is also affected by the dpi-aware option.
37 Examples:
39 • Dina:weight=bold:slant=italic
40 • Courier New:size=12
41 • Fantasque Sans Mono:fontfeatures=ss01
42 Default: monospace.
45 dpi-aware
47 auto, yes, or no.
48 When set to yes, fonts are sized using the monitor's DPI, making a
50 font of a given size have the same physical size, regardless of
51 monitor.
52 In this mode, the monitor's scaling factor is ignored; doubling the
54 scaling factor will not double the font size.
55 When set to no, the monitor's DPI is ignored. The font is instead
57 sized using the monitor's scaling factor; doubling the scaling fac‐
58 tor does double the font size.
59 Finally, if set to auto, fonts will be sized using the monitor's
61 DPI if all monitors have a scaling factor of 1. If at least one
62 monitor as a scaling factor larger than 1 (regardless of whether
63 the fuzzel window is mapped on that monitor or not), fonts will be
64 scaled using the scaling factor.
65 Note that this option typically does not work with bitmap fonts,
67 which only contains a pre-defined set of sizes, and cannot be dy‐
68 namically scaled. Whichever size (of the available ones) that best
69 matches the DPI or scaling factor, will be used.
70 Also note that if the font size has been specified in pixels (:pix‐
72 elsize=N, instead of :size=N), DPI scaling (dpi-aware=yes) will
73 have no effect (the specified pixel size will be used as is). But,
74 if the monitor's scaling factor is used to size the font (dpi-
75 aware=no), the font's pixel size will be multiplied with the scal‐
76 ing factor.
77 Default: auto.
79 prompt=
81 String to use as input prompt. Default: > .
82 icon-theme
84 Icon theme. Note that the name is case sensitive. Default: hicolor.
85 icons-enabled
87 Boolean. When enabled, application icons (from the selected icon-
88 theme) will be rendered. Default: yes.
89 fields
91 Comma separated list of XDG Desktop entry fields to match against.
92 Even though fuzzel only displays the application names, matching
94 can (and by default is) be done against other fields as well. Sup‐
95 ported fields are:
96 • filename
98 • name
99 • generic
100 • exec
101 • categories
102 • keywords
103 • comment
104 Default: filename,name,generic.
107 password-character
109 Default character to use with the command line option --password.
110 Note that this can be overridden on the command line, by explicitly
111 specifying the character with --password=X. Default: *.
112 fuzzy
114 Boolean. Enables or disables fuzzy matching. Default: yes.
115 show-actions
117 Boolean. Some desktop files define "actions", in addition to the
118 application itself. Examples are "new window", "preferences", etc.
119 When this option is enabled, those actions will be listed by
120 fuzzel. Default: no.
121 terminal
123 terminal command to use when launching 'terminal' programs, e.g.
124 "xterm -e". Default: $TERMINAL -e.
125 launch-prefix
127 Prefix to add before argv of executed program. Default: not set.
128 lines
130 Number of matches to show. Default: 15.
131 width
133 Window width, in characters. Border and margins are not included in
134 this. Default: 30.
135 horizontal-pad
137 Horizontal padding, in pixels, between border and content. Default:
138 40.
139 vertical-pad
141 Vertical padding, in pixels, between border and content. Default:
142 8.
143 inner-pad
145 Vertical padding between prompt and match list, in pixels. Default:
146 0.
147 image-size-ratio
149 The ratio of the large image displayed when there are only a "few"
150 matches, compared to the full window size. Default: 0.5.
151 line-height
153 Override line height from font metrics. Default: use font metrics.
154 letter-spacing
156 Additional letter spacing. Negative values are allowed. Default: 0.
157 layer
159 Which layer to render the fuzzel window on. Valid values are top
160 and overlay.
161 top renders above normal windows, but typically below fullscreen
163 windows and lock screens.
164 overlay renders on top of both normal windows and fullscreen win‐
166 dows. Note that the order is undefined if several windows use the
167 same layer. Since e.g. lock screens typically use overlay, that
168 means fuzzel may or may not appear on top of a lock screen.
169 Default: top
171 exit-on-keyboard-focus-loss
173 Boolean. If true, exit when the fuzzel window loses keyboard focus.
174 Setting this to false can be useful on compositors where enabling
176 "focus-follows-mouse" causes fuzzel to exit as soon as the mouse is
177 moved over another window. Sway (<= 1.7) exhibits this behavior,
178 for example.
179 Default: yes
181 l
182
184 All color values are in RGBA.
185 background
187 Background color. Default: fdf6e3dd.
188 text
190 Text (foreground) color of unselected entries. Default: 657b83ff.
191 match
193 Text (foreground) color of the matched substring. Default:
194 cb4b16ff.
195 selection
197 Background color of the selected entry. Default: eee8d5dd.
198 selection-text
200 Text (foreground) color of the selected entry. Default: 657b83ff.
201 selection-match
203 Text (foreground) color of the matched substring of the selected
204 entry. Default: cb4b16ff.
205 border
207 Border color. Default: 002b36ff.
208
210 width
211 Width of the border, in pixels. Default: 1.
212 radius
214 Amount of corner "roundness". Default: 10.
215
217 mode
218 One of text or index. Determines what fuzzel prints on stdout when
219 an entry is selected: text prints the entry itself, index prints
220 the index of the selected entry. Default: text.
221 exit-immediately-if-empty
223 Boolean. If enabled, fuzzel will not run at all (i.e. it will not
224 open a window, and will not print anything on stdout) if there's
225 nothing on stdin. Default: no.
226
228 This section lets you override the default key bindings.
229 The general format is action=combo1...comboN. That is, each action may
231 have one or more key combinations, space separated. Each combination is
232 in the form mod1+mod2+key. The names of the modifiers and the key must
233 be valid XKB key names.
234 Note that if Shift is one of the modifiers, the key must not be in up‐
236 per case. For example, Control+Shift+V will never trigger, but Con‐
237 trol+Shift+v will.
238 Note that Alt is usually called Mod1.
240 xkbcli interactive-wayland can be useful for finding keysym names.
242 A key combination can only be mapped to one action. Lets say you want
244 to bind Control+k to next. Since this is the default shortcut for
245 delete-line, you must unmap the default binding. This can be done by
246 setting action=none; e.g. delete-line=none.
247 cancel
249 Quite fuzzel without executing anythingDefault: Control+g Control+c
250 Escape.
251 execute
253 Execute the currently selected entry. Or, in dmenu mode, print the
254 selected entry on stdout. Default: Return KP_Enter Control+y.
255 execute-or-next
257 If there is a single match, execute it. If there are more than one
258 match, select the next entry. Wraps around when the last entry has
259 been reached. Default: Tab.
260 cursor-left
262 Moves the cursor one character to the left. Default: Left Con‐
263 trol+b.
264 cursor-left-word
266 Moves the cursor one word to the left. Default: Control+Left
267 Mod1+b.
268 cursor-right
270 Moves the cursor one character to the right. Default: Right Con‐
271 trol+f.
272 cursor-right-word
274 Moves the cursor one word to the right. Default: Control+Right
275 Mod1+f.
276 cursor-home
278 Moves the cursor to the beginning of the input. Default: Home Con‐
279 trol+a.
280 cursor-end
282 Moves the cursor to the end of the input. Default: End Control+e.
283 delete-prev
285 Deletes the character before the cursor. Default: BackSpace.
286 delete-prev-word
288 Deletes the word before the cursor. Default: Mod1+BackSpace Con‐
289 trol+BackSpace.
290 delete-next
292 Deletes the character after the cursor. Default: Delete.
293 delete-next-word
295 Deletes the word after the cursor. Default: Mod1+d Control+Delete.
296 delete-line
298 Deletes everything after the cursor. Default: Control+k.
299 prev
301 Select the previous entry. Does not wrap around when the first en‐
302 try has been reached. Default: Up Control+p.
303 prev-with-wrap
305 Select the previous entry. Wraps around when the first entry has
306 been reached. Default: ISO_Left_Tab.
307 prev-page
309 Switch to the previous page. Default: PageUp KP_PageUp.
310 next
312 Select the next entry. Does not wrap around when the last entry has
313 been reached. Default: Down Control+n.
314 next-with-wrap
316 Select the previous entry. Wraps around when the first entry has
317 been reached. Default: not bound.
318 next-page
320 Switch to the next page. Default: Page_Down KP_Page_Down.
321 custom-1, custom-2, ..., custom-19
323 Execute the currently selected entry, then exit with a non-zero
324 exit code. custom-1 exits with exit code 10, custom-2 with 11, cus‐
325 tom-3 with 12, and so on.
326 Default:
328 • custom-1: Mod1+1
329 • custom-2: Mod1+2
330 • custom-3: Mod1+3
331 • custom-4: Mod1+4
332 • custom-5: Mod1+5
333 • custom-6: Mod1+6
334 • custom-7: Mod1+7
335 • custom-8: Mod1+8
336 • custom-9: Mod1+9
337 • custom-10: Mod1+10
338 • custom-11: Mod1+11
339 • custom-12: Mod1+12
340 • custom-13: Mod1+13
341 • custom-14: Mod1+14
342 • custom-15: Mod1+15
343 • custom-16: Mod1+16
344 • custom-17: Mod1+17
345 • custom-18: Mod1+18
346 • custom-19: Mod1+19
347
350 fuzzel(1)
351 2022-11-04 fuzzel.ini(5)