Skip to content

Configuration

Jump to bottom
WolfwithSword edited this page Dec 27, 2025 · 7 revisions

App Settings

Config
  • Port: The port the webserver runs on for your browser sources
  • Default Currency: The currency to convert donations to when calculating time/points
  • Bits-Like as Donation: Whether or not to count Bits from Twitch, Bits/Beets from Blerp, etc, as money donations to count towards the donation sum
Options
  • Open Data Folder: Open the folder that all data is saved to
  • Export Events: Export all events for the current subathon to a CSV
  • Check for Updates: Check for updates, and if available, prompt to auto install
  • Help?: Opens your browser to this wiki
  • Undo Simulated Events: For the current subathon, delete all simulated events and undo their points/seconds that came from this settings page. Warning - this may bring you to negative time/points.

Twitch

Click connect to link your Twitch account. Once authenticated, it will display your username.

Options
  • Auto Pause: Pause on stream end
  • Auto Lock: Lock on stream end
  • Auto Resume: Resume on stream start
  • Auto Unlock: Unlock on stream start
Values
  • Cheers/Bits: Seconds per 100 bits, points per 100 bits (rounded). Includes powerups and combos.
  • Raids: Seconds per viewer, points per raid
  • Follows: Seconds per follow, points per follow
  • Charity Donations: Seconds per 1$, points per 1$ (rounded down). 1$ of Default Currency after conversion.
  • Subs: For T1, T2, T3, seconds and points per sub. Prime counts as T1
  • Gift Subs: For T1, T2, T3, seconds and points per sub gifted
  • Hype Trains: Checkbox to enable auto-multiplier on hype-train. Starts a new one with Multiplier, Time, Points settings speified if one is not active. On End, will end multiplier.

YouTube

Type in your YT Channel's Handle then click connect

Values
  • Super Chats: Seconds per 1$, Points per 1$ (rounded down). 1$ of Default Currency after conversion.
  • Memberships: Seconds and points per membership. Only supports single tier/level*
  • Gift Memberships: Seconds and points per membership gifted. Only supports single tier/level*

StreamElements

Go to your dashboard and copy your JWT Token, paste it in and click connect.

Values
  • Tips: Seconds per 1$, Points per 1$ (rounded down). 1$ of Default Currency after conversion.

StreamLabs

Go to your dashboard API Settings, go to API Tokens and copy your Socket API Token, paste it in and click connect.

Values
  • Donations: Seconds per 1$, Points per 1$ (rounded down). 1$ of Default Currency after conversion.

Chat Extensions

Blerp

To use Blerp, you need to have the default chat message notifications enabled, as we rely on parsing chat for the blerp account.

Supports both Bits and Beets, for both Twitch and YouTube chats.

Values
  • Bits: Seconds per 100, Points per 100 (rounded down). 1$ of Default Currency after conversion. Modifier is the amount that counts towards currency. For example, if you want 80% of the bits to count as money donations, put in 0.8
  • Beets: Seconds per 100, Points per 100 (rounded down). 1$ of Default Currency after conversion. Modifier is the amount that counts towards currency. For example, if you want 80% of the beets to count as money donations, put in 0.8

KoFi

KoFi setup requires Streamer.Bot. Clicking the setup button will bring you to the following guide for connecting KoFi to Streamer.Bot, as well as how to set up the actions.

Values
  • Donations: Seconds per 1$, Points per 1$ (rounded down). 1$ of Default Currency after conversion.
  • Memberships: Seconds and points per membership. Add more by clicking Add Membership Tier button. The name must match the tier name from KoFi to function.

External Generic Services

Generic external services can be configured to push both Subs and Donations. Subs require values in their POST body, but Donations can be configured per converted currency dollar unit here.

See Development for details.

Values
  • Donations: Seconds per 1$, Points per 1$ (rounded down). 1$ of Default Currency after conversion.

Chat Commands

For Twitch and Youtube Chat, commands can be used to control some aspects of the subathon manager. All commands can be triggered in chat via !<name> <options>.

Channel owner / broadcaster will have permissions for all commands.

For each command, you can set the following:

  • Name: The command name, such as addpts
  • Mods?: Can mods use this command?
  • VIPs?: [Twitch Only] Can VIPs use this command?
  • User Whitelist: Comma separated list of usernames that can use the command

Discord Webhooks

Log certain events to discord channels.

Config
  • Error Log URL: Webhook URL to log errors and notices from the application
  • Event Log URL: Webhook URL to log events for the subathon for audit logging. Sends in batches every minute
  • Log Simulated Events?: For event logs, log simulated events or not?
  • Log Patches?: Logs to error url, notify you of any remote patches to your subathon values configuration.
Options For each event type, you can choose which ones to log to the Event Log webhook.

Clone this wiki locally