1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
|
# NAME
tofi - configuration file
# DESCRIPTION
The config file format is basic .ini/.cfg style. Options are set one per
line, with the syntax:
> option = value
Whitespace is ignored. Values starting or ending with whitespace can be
given by enclosing them in double quotes like so:
> option = " value "
Lines beginning with \# or ; are treated as comments. Section headers of
the form \[header\] are currently ignored. All options and values are
case-insensitive, except where not possible (e.g. paths). Later options
override earlier options, and command line options override config file
options.
# OPTIONS
**font**=*font*
> Font to use. If *font* is a path to a font file, **tofi** will not
> have to use Pango or Fontconfig. This greatly speeds up startup, but
> any characters not in the chosen font will fail to render.
>
> If a path is not given, *font* is interpreted as a font name in Pango
> format.
>
> Default: "Sans"
**font-size**=*pt*
> Point size of text.
>
> Default: 24
**background-color**=*color*
> Color of the background. See **COLORS** for more information.
>
> Default: \#1B1D1E
**outline-width**=*px*
> Width of the border outlines.
>
> Default: 4
**outline-color**=*color*
> Color of the border outlines. See **COLORS** for more information.
>
> Default: \#080800
**border-width**=*px*
> Width of the border.
>
> Default: 12
**border-color**=*color*
> Color of the border. See **COLORS** for more information.
>
> Default: \#F92672
**text-color**=*color*
> Color of text. See **COLORS** for more information.
>
> Default: \#FFFFFF
**prompt-text**=*string*
> Prompt text.
>
> Default: "run: "
**num-results**=*n*
> Maximum number of results to display. If *n* = 0, tofi will draw as
> many results as it can fit in the window.
>
> Default: 0
**selection-color**=*color*
> Color of selected result. See **COLORS** for more information.
>
> Default: \#F92672
**selection-background**=*color*
> Background color of selected result. See **COLORS** for more
> information.
>
> Default: \#00000000
**result-spacing**=*px*
> Spacing between results. Can be negative.
>
> Default: 0
**min-input-width**=*px*
> Minimum width of input in horizontal mode.
>
> Default: 0
**width**=*px\|%*
> Width of the window. See **PERCENTAGE VALUES** for more information.
>
> Default: 1280
**height**=*px\|%*
> Height of the window. See **PERCENTAGE VALUES** for more information.
>
> Default: 720
**corner-radius**=*px*
> Radius of the window corners.
>
> Default: 0
**anchor**=*position*
> Location on screen to anchor the window. Supported values are
> *top-left*, *top*, *top-right*, *right*, *bottom-right*, *bottom*,
> *bottom-left*, *left*, and *center*.
>
> Default: center
**margin-top**=*px\|%*
> Offset from top of screen. See **PERCENTAGE VALUES** for more
> information. Only has an effect when anchored to the top of the
> screen.
>
> Default: 0
**margin-bottom**=*px\|%*
> Offset from bottom of screen. See **PERCENTAGE VALUES** for more
> information. Only has an effect when anchored to the bottom of the
> screen.
>
> Default: 0
**margin-left**=*px\|%*
> Offset from left of screen. See **PERCENTAGE VALUES** for more
> information. Only has an effect when anchored to the left of the
> screen.
>
> Default: 0
**margin-right**=*px\|%*
> Offset from right of screen. See **PERCENTAGE VALUES** for more
> information. Only has an effect when anchored to the right of the
> screen.
>
> Default: 0
**padding-top**=*px\|%*
> Padding between top border and text. See **PERCENTAGE VALUES** for
> more information.
>
> Default: 8
**padding-bottom**=*px\|%*
> Padding between bottom border and text. See **PERCENTAGE VALUES** for
> more information.
>
> Default: 8
**padding-left**=*px\|%*
> Padding between left border and text. See **PERCENTAGE VALUES** for
> more information.
>
> Default: 8
**padding-right**=*px\|%*
> Padding between right border and text. See **PERCENTAGE VALUES** for
> more information.
>
> Default: 8
**hide-cursor**=*true\|false*
> Hide the cursor.
>
> Default: false
**horizontal**=*true\|false*
> List results horizontally.
>
> Default: false
**history**=*true\|false*
> Sort results by number of usages.
>
> Default: true
**drun-launch**=*true\|false*
> If true, directly launch applications on selection when in drun mode.
> Otherwise, just print the path of the .desktop file to stdout.
>
> Default: false
**hint-font**=*true\|false*
> Perform font hinting. Only applies when a path to a font has been
> specified via **font-name**. Disabling font hinting speeds up text
> rendering appreciably, but will likely look poor at small font pixel
> sizes.
>
> Default: true
# COLORS
Colors can be specified in the form *RGB*, *RGBA*, *RRGGBB* or
*RRGGBBAA*, optionally prefixed with a hash (#).
# PERCENTAGE VALUES
Some pixel values can optionally have a % suffix, like so:
> width = 50%
This will be interpreted as a percentage of the screen resolution in the
relevant direction.
# AUTHORS
Philip Jones \<philj56@gmail.com\>
# SEE ALSO
**tofi**(5), **dmenu**(1) **rofi**(1)
|
