A marathon is a countdown clock for extended streams. Bits, subs, gifted subs and tips can all add time automatically, and the stream ends when it hits zero. The clock sits in OBS so viewers can see how much they've pushed it.
What it solves
Ordinary support is spent the moment it arrives — the viewer never sees what it changed. A marathon converts every contribution into how much longer you're staying, which is about as direct as cause and effect gets: they give, the clock jumps. And the countdown creates tension on its own, because it's always shrinking.
Getting started
- Set the starting time and add the clock's OBS URL as a browser source.
- On the rules page, set how much time each event adds (N seconds per 100 Bits, say).
- Start the countdown — or control it from chat with
!starttime/!pausetime.
Common misconceptions
- The time shown in the dashboard is a local estimate and may drift slightly from OBS. The clock in OBS is the one actually running; the dashboard figure is for your reference.
- By default, nothing adds time once the countdown reaches zero. Ended means ended. If you want support after zero to extend the stream anyway, enable that option explicitly.
- "Add used time" does not affect the countdown. It only adjusts the cumulative statistic — it isn't a way to give yourself more time.
- Bits sent via power-ups count too. Nothing is missed just because it came through an effect rather than a plain cheer.
- A tip containing a chosen keyword can subtract time instead of adding it. That's a deliberate mechanic, not a bug — some people will happily pay to send you to bed early.
- A custom flip-clock image must be 12 equal cells laid out horizontally. In order: 0–9, colon, minus. The overall proportions have to match the template or the digits will be misaligned.
Settings
Add or subtract countdown time based on viewer events.
Recent time changes (kept 7 days).
The text below is taken from the in-app help, so it stays in sync with the actual interface.
| Setting | What it does |
|---|---|
| Reduce keyword (empty = off) | If a Cheer/Sub message contains this keyword, the time is subtracted instead of added. |
| Keep adding after zero | When off, events stop adding time once the countdown hits zero. |
| Auto pause when offline | Automatically pause when the stream goes offline and resume when it goes live. |
| Font family | Pick from the list or type any system/custom font name (applies live in the preview). |
| Flip-clock animation | When on, digits roll over like a mechanical flip clock as they change; when off, they switch instantly for a cleaner look. |
| Custom number image | Custom flip-digit image: a horizontal strip of 12 equal cells, in order 0 1 2 3 4 5 6 7 8 9, colon, minus. It must match the template proportions or the digits will misalign. |
| Add elapsed time | Only increases the accumulated elapsed time; does not affect the countdown. |
Chat commands
These are the default command names; they can be renamed or given aliases in the dashboard.
!time— Query the remaining time of the timer!addtime— Time required to add manually (Negative numbers reduce time)!settime— Set time and start!pausetime— Pause the timer!starttime— Resume/start the timer
Other notes
- Or use
!addtime/!settime/!pausetime/!starttimein chat. - The time shown here is computed locally and may differ slightly from OBS.
- Bits sent via Power-ups also count. "N sec / M" means N seconds per M Bits.
- Marathon chat commands. Manage cooldown, aliases and permissions on the Commands page.
Other settings
These settings have no additional help text in the dashboard; only their names are listed here.
- Paused
- Running
- Add
- Subtract
- Set
- Resume
- Pause
- Add-time rules
- sec
- per
- Cheer (bits)
- Gift subs
- Sub Tier 1
- Sub Tier 2
- Sub Tier 3
- ECPay ($)
- OPay ($)
- PAYUNi
- NewebPay
- PayPal (USD)
- Unifi Pay
- Widget appearance
- Font size (px)
- Digit width (px)
- Font style
- Text color
- Text opacity
- Edge style
- Edge color
- Edge size
- Add-time color
- Add-time opacity
- Reduce-time color
- Reduce-time opacity
- Float text duration (sec)
- Preview add
- Preview reduce
- None
- Shadow
- Raised
- Inset
- Outline
- None
- Bold
- Italic
- Underline
- Strikethrough
- Logs
- (kept 7 days)
- No logs yet.
- paused
- resumed
- Timer status
- Remaining
- Elapsed
- Time management
- Reset start time
- This feature is exclusive to Pro.
- Bits
- subs
- amount
- USD
- Cheer
- Gift sub
- Subscription
- ECPay
- OPay
- PAYUNi donation
- NewebPay donation
- Manual
- Auto
- PayPal
- Unifi Pay donation
- Wheel
- Format reference:
- Template
- Example
- time
- Viewer commands
- Mod commands
- MOD only
- Manage commands
- Subscription
- Bits & gifts
- Donations
- Other rules
- Font
- Edge
- Add/Reduce flash
- Animation & image