This new release brings major improvements in reliability, control, and user comfort:

Improved Reliability

  • Verifies audio files exist before attempting to play them.
  • Non-blocking audio handling to prevent freezes.
  • Protection against invalid or illogical settings (sessions, minutes, etc.).
New Features

  • ON/OFF toggle to enable or disable sounds.
  • Mappable hotkeys in OBS: Start, Pause, Resume, Reset, Skip.
  • Auto-Start per Scene mode (automatically starts the timer when a specific scene is active).
  • Session logs & statistics.
  • Option to hide the mode label and show only the timer.
Display & Customization

  • Estimated end time (“End at”) display with toggle option.
  • Customizable “End at” text and separator.
  • Per-state colors (Focus / Short Break / Long Break) fully configurable.
  • 12h / 24h time format support.
Download & Usage

  • Compatible with OBS 28+ (Windows, Mac, Linux).
  • Minimalist script, ready to paste into OBS.
This update makes the script more powerful, more stable, and more customizable—while remaining simple to use.
Top