v1.0.2

Ad Break Timer v1.0.2

A small addition, requested by a user setting up their overlay.

Added

• A Stop button next to Copy and Test on both the Bar and Radial rows of the Links tab. Test still starts a plain 1 hour countdown for positioning things in OBS, Stop now clears it straight back to idle without needing to wait it out or reach for the API.

---

V1.0.0

Ad Break Timer v1.0.0

The first proper release. Everything from the v0.9.0 beta plus a lot more, tested end to end against real Twitch ad breaks, and a full pass through every file in the project hunting down bugs before shipping this.

New since the beta

Two ways to run it automatically

• Connected to Twitch: reacts to real ad breaks the instant they happen via EventSub, and keeps itself accurate in the background by polling Twitch's own ad schedule, self correcting for snoozes or manually run ads with no input needed.
• Not connected to Twitch: a basic local loop using the ad break length and time between ads set on the Timing tab, for anyone without a Twitch connection who still wants it to run itself. Twitch mode always takes priority if both could apply, no manual switching needed.
• Picks up the current schedule immediately if the app's opened, or reopened after a crash, mid stream, rather than waiting for the next ad to happen first.

A proper colour system

• Four independent colours per overlay: the colour while an ad's running, the colour between ads, a colour briefly shown when either one finishes, and the background.
• A built in colour picker, no need to know a hex code.
• Idle/finish behaviour is now a choice of flash, static, or hidden, with its own configurable duration.

Twitch connection improvements

• Shows your Twitch profile picture next to your channel name once connected.
• Checks the connection hourly, per Twitch's own requirements, and will prompt you to reconnect if access is revoked from Twitch's side rather than silently failing.

The app itself

• Single instance lock, a second copy shows a message and closes rather than running alongside the first.
• The window title and log file both show the running version, useful for support.
• A full diagnostic log, every command, every colour change, every Twitch event, all timestamped and readable.

Fixed since the beta

• A race condition where a real ad break and a background schedule check could interrupt each other under specific timing, occasionally cutting an ad's countdown short.
• The overlay's finish flash could be skipped entirely at the end of the ad free countdown, cutting straight to idle instead.
• Saving a new colour in Overlay settings could silently get overwritten by whatever the automatic cycle displayed next.
• Disconnecting a Twitch account left a background check running pointlessly instead of stopping cleanly.

Known limitations

• No installer yet, download the release zip and run the exe directly, or build from source.
• Windows only.

---

Made by Kaydee.Codes. Free to use, no data collected, ever.

v0.9.0-Beta

Ad Break Timer v0.9.0-Beta

First public beta. Core functionality is complete and tested against real Twitch ad breaks, this is a beta because there's no installer yet and it's still getting a final pass before v1.

Overlays

• Bar and radial ring overlays, driven by a local HTTP API, add either as an OBS Browser Source
• Fully responsive, no fixed canvas size, resizes with the Browser Source
• Direction (drain/fill for the bar, cw/ccw for the ring), size, thickness, and rotation are all configurable
• Three separate colours: ad-free colour, ad colour, and an idle/finish colour shown briefly when a countdown ends
• Idle/finish style is a choice of flash, static, or hidden, with a configurable duration
• A colour picker is built into the settings window, no need to know hex codes

Twitch integration

• Connects directly to your Twitch account using the Device Code flow, no password ever entered into the app
• Listens for real ad breaks live via EventSub and starts the overlay the instant one begins
• Polls Twitch's own ad schedule in the background to keep the ad-free countdown accurate, self-correcting for snoozes or manually run ads without any manual input
• Checks the connection hourly and will prompt to reconnect if access is revoked from Twitch's side
• Works from a cold start too: opening the app mid-stream, or after a crash, picks up the current schedule immediately rather than waiting for the next ad

Manual control

• The full command API works standalone as well, for anyone using Streamer.bot or triggering commands by hand instead of connecting Twitch

The app itself

• Single instance lock, only one copy can run at a time
• Starts automatically on launch (optional) and minimises to the system tray
• A traffic light status indicator and a detailed log file for troubleshooting
• Config, overlay state, and the Twitch connection are all stored locally under %AppData%\AdBreakTimer

Known limitations

• No installer yet, currently run from source or a self-built exe
• Windows only