ENDE

Subathon

The Subathon tool lets you run a countdown timer that automatically extends when viewers follow, sub, gift subs, or cheer bits. You control everything from the dashboard and add the overlay to OBS.

Dashboard overview

On the Subathon page you configure:

  • Start time (hours/minutes)
  • Time additions per event (e.g., Tier 1 Sub, Prime Sub, 100 Bits)
  • Additional additions for raid and raid viewers
  • Enable/disable each addition (slider)
  • Manual time add/subtract while the timer is running
  • Overlay styling (font, colors, size, label)
  • Chat commands for start/pause and for adding/removing minutes or seconds
  • Optional chat feedback for the commands (custom text)
  • Donation integrations for Ko-Fi, Tipeeestream, and ByteMate Donations (seconds per donation)

Start and control

  1. Set the start time.
  2. Click Start.
  3. While running you can Pause or Reset.
  4. Use the + and − buttons to manually add or subtract time. Enter the amount (seconds or minutes) in the field next to them.

Reset stops the timer completely and clears it.

Count events while paused

In the bottom-right corner of the timer controls you'll find the "Count events while paused" toggle. When enabled (the default), subs, bits, follows and other events are still added to the timer even while the subathon is paused. If you disable it, no automatic time is added during pause mode — manual adjustments via the +/− buttons still work at any time.

Time additions

All additions are entered in seconds. Each addition has its own value and can be enabled/disabled with the slider.

Examples:

  • Tier 1 Sub: 120 seconds
  • Tier 2 Sub: 240 seconds
  • Follow: 30 seconds
  • Raid: 60 seconds
  • Raid viewers: 2 seconds per viewer

Anti-spam: follow cooldown

To prevent spam from unfollow/refollow, a follow only counts once per hour per user.

Donation integrations

Donations from multiple sources can automatically add time to the timer:

  • Ko-Fi – requires a connection under Account → Linked Accounts.
  • Tipeeestream – requires a connection under Account → Linked Accounts.

For each source you set separately how many seconds per €1/$1 are added. Amounts are converted proportionally – e.g. €5 × 60 sec = 300 seconds.

OBS overlay

Use the Overlay link as a browser source in OBS. Recommended sizes are around 400x200 or similar. The preview always shows a timer (dummy time if no session is running).

Styling & preview

  • Background color (optional transparent)
  • Text color & accent color
  • Font & font size
  • Optional label (title above the timer)

Click Preview to test the overlay. If the timer is running, you'll see the real time; otherwise a dummy time is shown.

Chat commands

You can enable and rename the start/pause command (default: !timer).

The time add/subtract command supports the following syntax:

  • !add +5m → add 5 minutes
  • !add -5m → subtract 5 minutes
  • !add +10s → add 10 seconds
  • !add -10s → subtract 10 seconds
  • No sign means add. Without m or s, minutes are assumed (e.g., !add 5).

Chat feedback (optional)

You can decide per command whether a chat confirmation is sent and define the message. Use {action} as a placeholder, e.g.:

  • Subathon: {action}
  • Timer {action}

Examples for actions:

  • started
  • paused
  • resumed
  • +5 minutes / -5 minutes