1fuzzel(1) General Commands Manual fuzzel(1)
2
3
4
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
15 The window size, font and colors can be configured with command line
16 options:
17
18 -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
22 The default is to let the compositor choose output.
23
24 -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
28 -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
33 In this mode, the monitor's scaling factor is ignored; doubling the
34 scaling factor will not double the font size.
35
36 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
40 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
46 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
51 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
58 Default: auto
59
60 -P,--prompt=PROMPT
61 Prompt to use. Default: > .
62
63 -i,--icon-theme=NAME
64 Icon theme to use. Example: Adwaita. Default: hicolor.
65
66 -I,--no-icons
67 Do not render any icons.
68
69 -T,--terminal=TERMINAL ARGS
70 Command to launch XDG applications with the property Terminal=true
71 (htop, for example). Example: xterm -e. Default: not set.
72
73 -l,--lines=COUNT
74 The (maximum) number of matches to display. This dictates the win‐
75 dow height. Default: 15.
76
77 -w,--width
78 Window width, in characters. Margins and borders not included. De‐
79 fault: 30.
80
81 -x,--horizontal-pad=PAD
82 Horizontal padding between border and icons and text. In pixels,
83 subject to output scaling. Default: 40.
84
85 -y,--vertical-pad=PAD
86 Vertical padding between border and text. In pixels, subject to
87 output scaling. Default: 8.
88
89 -p,--inner-pad=PAD
90 Vertical padding between prompt and match list. In pixels, subject
91 to output scaling. Default: 0.
92
93 -b,--background=HEX
94 Background color. See COLORS. Default: fdf6e3dd.
95
96 -t,--text-color=HEX
97 Text color. See COLORS. Default: 657b83ff.
98
99 -m,--match-color=HEX
100 The color of matching substring(s). As you start typing in the
101 search box, the matching part in each application's name is high‐
102 lighted with this color. See COLORS. Default: cb4b16ff.
103
104 -s,--selection-color=HEX
105 The color to use as background of the currently selected applica‐
106 tion. See COLORS. Default: eee8d5ff.
107
108 -S,--selection-text-color=HEX
109 The text color of the currently selected application. See COLORS.
110 Default: 0x657b83ff.
111
112 -B,--border-width=INT
113 The width of the surrounding border, in pixels (subject to output
114 scaling). Default: 1.
115
116 -r,--border-radius=INT
117 The corner curvature. Larger means more rounded corners. 0 disables
118 rounded corners. Default: 10.
119
120 -C,--border-color=HEX
121 The color of the border. See COLORS. Default: 002b36ff.
122
123 -d,--dmenu
124 dmenu compatibility mode. In this mode, the list entries are read
125 from stdin (newline separated). The selected entry is printed to
126 stdout. If the input string does not match any of the entries, the
127 input string is printed as is on stdout.
128
129 -R,--no-run-if-empty
130 Exit immediately, without showing the UI, if stdin is empty. dmenu
131 mode only.
132
133 --line-height=HEIGHT
134 Override line height from font metrics. In points by default, but
135 can be specified as pixels by appending 'px' (i.e. --line-
136 height=16px). Default: not set.
137
138 --letter-spacing=AMOUNT
139 Additional space between letters. In points by default, but can be
140 specified as pixels by appending 'px' (i.e. letter-spacing=5px).
141 Negative values are supported. Default: 0.
142
143 -v,--version
144 Show the version number and quit
145
147 The font is specified in FontConfig syntax. That is, a colon-separated
148 list of font name and font options.
149
150 Examples:
151 • Dina:weight=bold:slant=italic
152 • Arial:size=12
153
154
156 All colors must be specified as a RGBA quadruple, in hex format, with‐
157 out a leading '0x'.
158
159 EXAMPLES:
160 • white: ffffffff (no transparency)
161 • black: 000000ff (no transparency)
162 • black: 00000010 (semi-transparent)
163 • red: ff0000ff (no transparency)
164
165
166 The default color scheme is Solarized.
167
168
169
170 2021-11-13 fuzzel(1)