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). If the audio system is unavailable, it will automatically fall back to the system beep or disable 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"