Audio Issues

No Sound Notifications

Problem

Timer works but no audio plays during transitions.

Solution

1. Check audio configuration:

   # $XDG_CONFIG_HOME/tomat/config.toml
   [sound]
   mode = "embedded"  # Must not be "none"
   

2. Test system audio:

   # Test if ALSA works
   aplay /usr/share/sounds/alsa/Front_Left.wav
   
   # Or try speaker-test
   speaker-test -t sine -f 1000 -l 1
   

3. Check volume levels:

   • System volume (alsamixer, pavucontrol)
   • Tomat volume in config (0.0-1.0)

4. Try different audio modes:

   [sound]
   mode = "system-beep"  # Use system beep instead
   

Wrong Audio Device

Problem

Audio plays on wrong device or not audible.

Solution

1. Check default ALSA device:

   aplay -l  # List audio devices
   cat ~/.asoundrc  # Check ALSA configuration
   

2. Use system beep as fallback:

   [sound]
   mode = "system-beep"
   

Custom Sound Files Not Working

Problem

Custom sound files don’t play.

Solution

1. Check file paths and existence:

   ls -la /path/to/your/sound.ogg
   

2. Verify file format (must be supported audio format):

   file /path/to/your/sound.ogg
   # Common formats: WAV, OGG, FLAC, MP3
   

3. Test file with system player:

   aplay /path/to/your/sound.wav
   

4. Use absolute paths:

   [sound]
   mode = "embedded"
   work_to_break = "/home/user/sounds/work-done.ogg"  # Absolute path