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
25 Font and style to use, in fontconfig format. See FONT FORMAT. De‐
26 fault: monospace.
27
28 -i,--icon-theme=NAME
29 Icon theme to use. Example: Adwaita. Default: hicolor.
30
31 -I,--no-icons
32 Do not render any icons.
33
34 -T,--terminal=TERMINAL ARGS
35 Command to launch XDG applications with the property Terminal=true
36 (htop, for example). Example: xterm -e. Default: not set.
37
38 -l,--lines=COUNT
39 The (maximum) number of matches to display. This dictates the win‐
40 dow height. Default: 15.
41
42 -w,--width
43 Window width, in characters. Margins and borders not included. De‐
44 fault: 30.
45
46 -x,--horizontal-pad=PAD
47 Horizontal padding between border and icons and text. In pixels,
48 subject to output scaling. Default: 40.
49
50 -y,--vertical-pad=PAD
51 Vertical padding between border and text. In pixels, subject to
52 output scaling. Default: 8.
53
54 -b,--background=HEX
55 Background color. See COLORS. Default: fdf6e3dd.
56
57 -t,--text-color=HEX
58 Text color. See COLORS. Default: 657b83ff.
59
60 -m,--match-color=HEX
61 The color of matching substring(s). As you start typing in the
62 search box, the matching part in each application's name is high‐
63 lighted with this color. See COLORS. Default: cb4b16ff.
64
65 -s,--selection-color=HEX
66 The color to use as background of the currently selected applica‐
67 tion. See COLORS. Default: eee8d5ff.
68
69 -B,--border-width=INT
70 The width of the surrounding border, in pixels (subject to output
71 scaling). Default: 1.
72
73 -r,--border-radius=INT
74 The corner curvature. Larger means more rounded corners. 0 disables
75 rounded corners. Default: 10.
76
77 -C,--border-color=HEX
78 The color of the border. See COLORS. Default: 002b36ff.
79
80 -d,--dmenu
81 dmenu compatibility mode. In this mode, the list entries are read
82 from stdin (newline separated). The selected entry is printed to
83 stdout.
84
85 -R,--no-run-if-empty
86 Exit immediately, without showing the UI, if stdin is empty. dmenu
87 mode only.
88
89 --line-height=HEIGHT
90 Override line height from font metrics. In points by default, but
91 can be specified as pixels by appending 'px' (i.e. --line-
92 height=16px). Default: not set.
93
94 --letter-spacing=AMOUNT
95 Additional space between letters. In points by default, but can be
96 specified as pixels by appending 'px' (i.e. letter-spacing=5px).
97 Negative values are supported. Default: 0.
98
99 -v,--version
100 Show the version number and quit
101
103 The font is specified in FontConfig syntax. That is, a colon-separated
104 list of font name and font options.
105
106 Examples:
107 • Dina:weight=bold:slant=italic
108 • Arial:size=12
109
110
112 All colors must be specified as a RGBA quadruple, in hex format, with‐
113 out a leading '0x'.
114
115 EXAMPLES:
116 • white: ffffffff (no transparency)
117 • black: 000000ff (no transparency)
118 • black: 00000010 (semi-transparent)
119 • red: ff0000ff (no transparency)
120
121
122 The default color scheme is Solarized.
123
124
125
126 2021-05-04 fuzzel(1)