Toot can be configured via a TOML settings file.
Introduced in toot 0.37.0
Warning: Settings are experimental and things may change without warning.
Toot will look for the settings file at:
~/.config/toot/settings.toml(Linux & co.)
Toot will respect the
XDG_CONFIG_HOME environement variable if it's set and
look for the settings file in
$XDG_CONFIG_HOME/toot instead of
[common] section includes common options which are applied to all commands.
[common] # Whether to use ANSI color in output color = true # Enable debug logging, shows HTTP requests debug = true # Redirect debug log to the given file debug_file = "/tmp/toot.log" # Log request and response bodies in the debug log verbose = false # Do not write to output quiet = false
Defaults for command arguments can be override by specifying a
For example, to override
[commands.post] editor = "vim" sensitive = true visibility = "unlisted" scheduled_in = "30 minutes"
Introduced in toot 0.39.0
You can view images in a toot using an external program by setting the
tui.media_viewer option to your desired image viewer. When a toot is focused,
m will launch the specified executable giving one or more URLs as
arguments. This works well with image viewers like
feh which accept URLs as
[tui] media_viewer = "feh"
TUI uses Urwid which provides several color modes. See Urwid documentation for more details.
By default, TUI operates in 16-color mode which can be changed by setting the
color setting in the
[tui] section to one of the following values:
TUI defines a list of colors which can be customized, currently they can be seen
in the source code. They can be overriden in the
Each color is defined as a list of upto 5 values:
- foreground color (16 color mode)
- background color (16 color mode)
- monochrome color (monochrome mode)
- foreground color (high-color mode)
- background color (high-color mode)
Any colors which are not used by your desired color mode can be skipped or set to an empty string.
For example, to change the button colors in 16 color mode:
[tui.palette] button = ["dark red,bold", ""] button_focused = ["light gray", "green"]
In monochrome mode:
[tui] colors = 1 [tui.palette] button = ["", "", "bold"] button_focused = ["", "", "italics"]
In 256 color mode:
[tui] colors = 256 [tui.palette] button = ["", "", "", "#aaa", "#bbb"] button_focused = ["", "", "", "#aaa", "#bbb"]