Sound Settings

The [sound] section controls audio notifications when transitioning between work/break phases. By default, tomat plays high-quality WAV files built into the application. On Linux, this requires ALSA (Advanced Linux Sound Architecture); on macOS, Tomat uses Core Audio without additional dependencies. If the audio system is unavailable, Tomat falls back to the system beep or disables audio.

[sound]
mode = "embedded"
volume = 0.5

Options

mode

Sound notification mode. Controls how phase transitions are announced.

"embedded" (default)

Use built-in audio files

"system-beep"

Use system beep (terminal bell)

"none"

No sound notifications

volume

Audio volume level for embedded and custom sounds (0.0-1.0). Default: 0.5

work_to_break

Path to custom sound file for work→break transitions. Overrides embedded sound. Optional.

break_to_work

Path to custom sound file for break→work transitions. Overrides embedded sound. Optional.

work_to_long_break

Path to custom sound file for work→long break transitions. Overrides embedded sound. Optional.

"enabled"

Enable sound notifications.

Warning

Deprecated option. Use mode = "embedded" instead.

"system_beep"

Use system beep.

Warning

Deprecated option. Use mode = "system-beep" instead.

"use_embedded"

Use embedded sounds.

Warning

Deprecated option. Use mode = "embedded" instead.

Examples

To use your own sound files, keep mode = "embedded" and specify paths to your audio files. Custom sounds override the built-in ones:

[sound]
mode = "embedded"
work_to_break = "/home/user/sounds/work-done.ogg"
break_to_work = "/home/user/sounds/break-over.ogg"
work_to_long_break = "/home/user/sounds/long-break.ogg"
volume = 0.7

To disable all audio:

[sound]
mode = "none"

To use system beep only:

[sound]
mode = "system-beep"