Megathon

Thanks for downloading our widget!

Here you will find instructions on how to set everything up and an in-depth description of its possibilities.

⚠️ Take note: This widget is hosted on StreamElements and works only with StreamElements donations — make sure you have a StreamElements account before setting it up!

This is a highly customizable Subathon Widget designed for StreamElements, supporting both Twitch and YouTube. It provides a dynamic timer, comprehensive statistics tracking, a multi-goal milestone system, and engaging visual notifications to keep your community informed and excited throughout your subathon event. The widget leverages Twitch’s sub tier system, calculating progress based on tiers rather than subscription months, ensuring fair and accurate tracking.

Log in to StreamElements with your Youtube or Twitch account
Go to the “2. Widget” folder in the package you’ve downloaded
Pick the file that corresponds to your streaming platform (Twitch or YouTube) and double-click to install it.

Voila! Your widget is installed!

Pick your widget in your StreamElements dashboard and click “Edit”
Click on “Layers” and go to your widget.
Go to the “Settings” tab

Woohoo, here you can customize everything to your taste :)

⚠️ IMPORTANT

For all of your customizations to take effect, you need to press "Save" in the top right corner of the editor and refresh the page before adding the widget to your streaming software!

Core Features

Dynamic Timer System:
- Displays time in HH:MM:SS format with a visually distinct seconds display.
- Animated clock icon integrated with the timer.
- Timer duration increases based on events (subs/memberships, bits/SuperChats, tips/donations).
- Configurable initial, minimum, and maximum timer thresholds.
- Full control via chat commands: start, stop, pause, resume, add time, remove time, set specific time.
- Persistent state: timer and stats are saved and restored on widget load.
Comprehensive Stats Tracking:
- Real-time counters for subs/members, bits/SuperChats, and tips/donations.
- Displays total time added to the subathon.
- Optional detailed stats overlay showing more in-depth information, including top contributors.
- Icon + value layout for quick visual understanding.
- Chat command to reset stats if needed.
Advanced Goal System:
- Configure up to 20 unique goals.
- Each goal can have a custom name and goal value.
- Visual display of the next upcoming goals, including its name, goal, and a progress indicator.
- Automatic detection and celebration of reached goals with animations (e.g., confetti).
- Chat commands to manually navigate or check goal status.
Engaging Visual Design & Notifications:
- Modern, clean, and highly customizable interface with numerous styling options.
- Animated components for timer digits, goal unlocks, and notifications.
- Customizable main title section.
- Notification bubble system to announce new events (subs, cheers, donations) with customizable messages.
- Extensive control over fonts, colors, glows, borders, spacing, and backgrounds for all elements.

Customization Fields

Basic Setup (Megathon)

Name	Rewritten Description
Widget Title	Set the label shown above the timer.
Show Title	Toggle the title visibility.
Show Progress Bar	Display the goals progress bar.
Show Progress Value	Show numeric progress next to the bar.
Show Seconds in Timer	Include seconds in the main timer display.
Widget Scale	Uniformly scale the entire widget.
Number of Goals Shown	Limit how many goals are visible at once.
Blur Next Goal	Softly blur the next goal card for a “locked” look.
Show Goals to the Right of Timer	Move the goals UI to the right side of the timer.

Timer Settings

Name	Rewritten Description
Auto-start Timer	Start counting as soon as the widget loads.
Minimum Timer (minutes)	Lower bound for the timer duration.
Maximum Timer (minutes)	Upper bound for the timer duration.
Initial Timer (minutes)	Starting value for the timer on load/reset.

Time Rewards

Twitch:
- Seconds Added per Sub, Tier 2/3 Sub Bonus Multipliers, Gift Sub Multiplier
- Seconds Added per 100 Bits
- Seconds Added per $1 Donation
YouTube:
- Seconds Added per Membership
- Seconds per $1 SuperChat
- Seconds per $1 Super Sticker
- Seconds per $1 Donation

These determine how events and chat commands translate into time adjustments.

Points Rewards (Megathon)

Name	Rewritten Description
Points per Tier 1 Sub	Base points for a T1 sub.
Tier 2 Points Multiplier	Multiplier for T2 subs.
Tier 3 Points Multiplier	Multiplier for T3 subs.
Gift Sub Points Multiplier	Multiplier for gifted subs.
Points per 100 Bits	Points per 100 Twitch bits.
Points per $1 Donation	Points for each $1 tip.
Points per $1 SuperChat	Points per $1 SuperChat.
Points per $1 Super Sticker	Points per $1 Super Sticker.

Chat Commands & Permissions

Name	Rewritten Description
Who Can Use Commands?	Choose who can control the widget via chat (platform-aware).
Main Control Command	Base command prefix, e.g., `!subathon` .
Stats Overlay Command	Toggle the stats overlay, e.g., `!stats` .
Goal Control Command	Manage goals, e.g., `!goal` .
Pause/Resume Commands	`!pause` and `!resume` for timer control.
Set Timer Command	`!set` to set the timer (Megathon supports compound times).
Reset Subathon Command	`!reset` to perform a full reset.
Add/Remove Commands	`!add` and `!subtract` for time, points, or reward-based adjustments.

Permissions

Twitch: broadcaster, moderator, VIP, subscriber, everyone (via badges).
YouTube: owner, moderator, sponsor (member), everyone (via authorDetails flags).

Fonts & Sizing

Name	Rewritten Description
Widget Font Family/Weight	Global font family and weight.
Title Font Size	Title size.
Timer Font Size	Main timer size.
Stats Font Size	Stats row font size.
Goal Font Size	Goal text size.
Notification Font Family/Weight/Size	Pop-up notification font settings.

Colors

Title Color, Timer Color, Stats Text Color
Goal Badge/Numbers Color, Goal Text Color
Progress Bar Track/Fill/Text (Megathon)
Confetti Color
Detailed Stats: Value/Title/Background/Pill colors
Stats Icons Color (Megathon) or per-stat icons (subs/bits/tips)

Effects & Styling

Name	Rewritten Description
Timer Glow (enable, color, blur)	Glow around timer digits.
Title Glow (enable, color, blur)	Glow around title text.
Strokes (Timer/Title/Stats/Goal)	Outline width and color.

Background & Layout

Name	Rewritten Description
Enable Background	Toggle a background block.
Background Color	Background fill color.
Background Inset (px)	Padding inside background block.
Border Radius/Width/Color	Background box border styling.
Background Glow (Megathon)	Glow blur/color behind background.
Vertical/Horizontal Spacing	Internal spacing between pieces.
Timer Scale	Scale timer group.

Detailed Stats Overlay

Name	Rewritten Description
Show Stats (Test Mode)	Force overlay visible while configuring.
Font Family	Font for overlay.
Value/Title/Pill/Background Colors	Overlay theme colors.

Pop-Up Notification

Name	Rewritten Description
Notification Duration (s)	Visibility time of pop-up.
Pop-Up Vertical Position	Move the notification up/down.
Pop-Up Color / Text Color	Bubble and text colors.

Milestone Goals (1–20)

Each goal i has:

Name
Target Number
Type/Currency:
- Twitch: subs, bits, tips
- YouTube: Members (subs), SuperChats (bits), Tips ($)

Settings Buttons

Button	Action
Reset Timer	Resets only the countdown to Initial Timer (minutes).
Reset All (Time + Stats)	Resets time, stats, and goal states; auto-starts if enabled.

Chat Commands — Full Guide

Below uses default names; you can rename them in settings.

Permissions
- Twitch: based on badges (broadcaster > moderator > VIP > subscriber > everyone).
- YouTube: based on authorDetails (owner > moderator > sponsor > everyone).
- Only allowed roles per “Who Can Use Commands?” can run commands.
Stats Overlay
- !stats → Toggle overlay on/off. The main widget hides when overlay is visible.
Goals
- !goal next → Immediately unlock next unreached goal.
- !goal goto <number> → Jump to a specific goal index (1-based).
Main Control
- !subathon start → Start (or start after stop).
- !subathon pause → Pause timer.
- !subathon stop → Stop timer.
- !subathon status → Show current time and state.
- !subathon help → Show available subcommands.
- !subathon set <time> → Set timer directly.
  - Megathon accepts compound times: “1h 20m 30s”, “90s”, “5m”, “2h”.
Adding/Removing Time
- Pure time (both platforms):
  - !add 5m , !subtract 30s , !set 1h 20m
- Points (both platforms):
  - !add points 50
  - !subtract points 25
  - !subathon add points 100
  - !subathon remove points 10
- Twitch rewards:
  - Subs: !add sub , !add sub 3 , !add sub tier2 2 , !add sub tier3 1 , !add gifts 5
  - Bits: !add bits 500
  - Tips: !add donation $10
- YouTube rewards:
  - Members: !add member , !add member 3
  - SuperChat: !add sc $5
  - Super Sticker: !add ss $5
  - Tips: !add tips $10
Reset
- !reset → Full reset (time + stats + goals). Auto-starts if Auto-start is enabled.

Notes

Reward conversions use the Time Rewards settings for your platform.
Megathon supports compound time parsing for !set /!add /!remove .
At timer end, Megathon shows confetti and keeps the main UI visible; it does not auto-open the stats overlay.