Docs › Tools › Event Countdown

Tools docs

Event Countdown

A countdown to an event you choose, in the time zone you choose.

The overlay counts down to a date and time you choose and shows the days, hours, minutes and seconds left. It can show a name for the event above the numbers, and a message of your own when the countdown reaches zero. It needs no account and no key, and it asks no other service for anything.

It is separate from the Streamathon / Subathon timer. That timer counts the time you are live and is set up from your Dual IRL account. This one only counts down to a fixed date and time.

Open the Event Countdown builder, from the Tools page or from Seasonal tools. The preview at the top counts down to a sample moment a little over two days ahead until you choose a date and time. Its label reads Sample and then Your event. The Your overlay URL box stays empty, with a warning, until the builder has a valid date and time and at least one of days, hours, minutes or seconds to show. Then Copy URL and Open work. See Add a tool to OBS for the browser source.

Start from a day

The buttons at the top of Event fill the form in for you: Christmas, Halloween and New Year's. Each sets the name, the next date that day comes round in your time zone at midnight, a closing message and a matching number color. Change anything afterwards. The Seasonal tools page links straight to the builder with one of these already chosen.

On the day itself the midnight has already passed, so a button pressed that day gives a countdown that shows its closing message until the day is over. Once the day has gone, the buttons fill in the following year’s date.

The event

Event name
Optional, up to 60 characters. It shows above the numbers.
Date
The day of the event.
Time
The time of day on that date. It starts at 00:00.
Time zone
The zone the date and time are on the clock of. See below.
Show
Tick Days, Hours, Minutes and Seconds. The largest one you keep counts everything above it, so with the days turned off, two days and three hours shows as 51 hours.
When it reaches zero, show
The message shown once the time has come, up to 60 characters. The start is “It’s here!”. Leave it empty to show nothing.

If you pick a date and time that has already passed, the builder says so and the overlay shows the closing message.

Time zones

The date and time are on the clock of the zone you choose, wherever the overlay is played. The list starts on your device’s zone. A countdown to 09:00 in New York ends at 09:00 on a New York clock, whichever zone your streaming computer is set to. The link always carries the date, time and zone together for that reason.

Clock changes such as daylight saving are handled. If the clock shows your chosen time twice when the clocks go back, the first one counts. If the clock skips it when they go forward, the countdown ends right after the skip.

The overlay counts with the clock of the device it runs on. A device whose clock is wrong shows the wrong time left.

The look

Layout
In a row or Stacked, one unit under another. A row that does not fit the width of the source wraps onto a second line.
Position
Left, Center or Right in the browser source.
Font
Sans-serif, Serif, Monospace or Rounded. These are fonts your device already has.
Number size (px)
From 16 to 160. The start is 48. The name, the labels and the spacing follow it.
Text color
The name and the labels. The start is white.
Number color
The numbers and the closing message.
Card background
See-through to start, with Transparent ticked. Untick it to pick a color for a card behind the countdown.
Corner radius (px)
From 0 to 60. The start is 14. It only shows with a card background.

What shows when

Advanced: change it in the link

Everything the builder does is a setting in the link after the #. Your browser does not send that part to our server. Only settings you change are written, except the date, time and zone, which are always there.

SettingValuesStarts as
nametext, up to 60 charactersnone
atthe date and time as 2026-12-25T00:00none
tza time zone name such as America/New_Yorknone
unitsany of d, h, m, sdhms
donetext, up to 60 characters, or emptyIt’s here!
layoutrow, stackrow
alignleft, center, rightleft
fontsans, serif, mono, roundedsans
size16 to 160 pixels48
fg, accentcolors such as ffcc00white, teal
bga color, or transparenttransparent
radius0 to 60 pixels14

A setting that is missing or not valid takes its start value, and a number outside its range is held to the nearest end of it. Without a valid at and tz the overlay shows its note.