Configuration Guide

Tomat supports comprehensive configuration via a TOML file. On Linux, the path is $XDG_CONFIG_HOME/tomat/config.toml (typically ~/.config/tomat/config.toml); on macOS, it is ~/Library/Application Support/tomat/config.toml. Set TOMAT_CONFIG to override the platform default.

The configuration file is organized into five main sections:

[timer]

timer durations and behavior

[sound]

for audio notification settings

[notification]

for desktop notification settings [display] for output

[display]

for output formatting

[hooks]

for custom commands triggered by timer events