Provided by: tofi_0.5.0-1_amd64 
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-match-color=color
Color of the matching portion of the selected result. This will not always be shown if
the fuzzy-match option is set to true. Any color that is fully transparent (alpha = 0)
will disable this highlighting. See COLORS for more information.
Default: #00000000
selection-padding=px
Extra horizontal padding of the selection background. If px = -1, the padding will
fill the whole window width.
Default: 0
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
output=name
The name of the output to appear on, if multiple outputs are present. If empty, the
compositor will choose which output to display the window on (usually the currently
focused output).
Default: ""
scale=true|false
Scale the window by the output's scale factor.
WARNING: In the next version of tofi, this will default to true, so set this to false
now if you don't want that behaviour. Note that currently, font scaling will still
occur when this is set to false - that will change when true becomes the default.
Default: false
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 in run and drun modes.
Default: true
fuzzy-match=true|false
If true, searching is performed via a simple fuzzy matching algorithm. If false,
substring matching is used, weighted to favour matches closer to the beginning of the
string.
Default: false
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
drun-print-exec=true|false
WARNING: In the current version of tofi, this option has changed to always be true and
has no effect, as it should have been from the start. It may be removed in a future
version of tofi.
Default: true.
hint-font=true|false
Perform font hinting. Only applies when a path to a font has been specified via font.
Disabling font hinting speeds up text rendering appreciably, but will likely look poor
at small font pixel sizes.
Default: true
late-keyboard-init=true|false
Delay keyboard initialisation until after the first draw to screen. This option is
experimental, and will cause tofi to miss keypresses for a short time after launch.
The only reason to use this option is performance on slow systems.
Default: false
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)
2022-08-21 tofi(5)