Custom Alert Text Guide

You can customize the text displayed on your alerts by creating a JSON file and hosting it on Pastebin (or similar service). This allows you to personalize the header and description text for each alert type.

How It Works

1. Create a JSON file with your custom text
2. Upload it to Pastebin.com
3. Copy the raw URL (e.g., https://pastebin.com/raw/XXXXXXXX)
4. Paste it in the "Custom Alert Text" field in the customizer
5. Generate your overlay URL

You can assign specific themes to individual users. When these users trigger any alert (follow, sub, bits, etc.), their alerts will use their assigned theme instead of the default.

Configuration

{
    "userOverrides": {
        "krookediles": "xboxachievement",
        "rod_legion": "ps5trophy"
    },
    "ps5trophy": {
        ...
    },
    "xboxachievement": {
        ...
    }
}

How It Works

• userOverrides - Map usernames to their preferred theme (case-insensitive)
• The default theme is whatever you select in the customizer
• Users in the overrides list will use their assigned theme instead
• Theme names: xboxachievement, ps5trophy, rpgquest, luxury, modern, esportsclassic, xbox, ps5, rpg, lux, mod, esports

Example Use Cases

• Give VIPs or mods a special Xbox achievement theme
• Assign different themes to friends or regular supporters
• Create a unique experience for specific community members

Copy this template and customize it with your own text. You only need to include the events you want to customize - any missing events will use the default text.

{
    "TwitchFollow": {
        "header": "New Follower!",
        "subtitle": "%username% just followed!"
    },
    "TwitchCheer": {
        "header": "%bits% Bits!",
        "subtitle": "%username% cheered %bits% bits!"
    },
    "TwitchSub": {
        "header": "New Subscriber!",
        "subtitle": "%username% subscribed with %tiertext%!"
    },
    "TwitchReSub": {
        "header": "%months% Month Resub!",
        "subtitle": "%username% resubscribed for %months% months!"
    },
    "TwitchGiftedSub": {
        "header": "Gift Sub!",
        "subtitle": "%username% gifted a sub to %recipient%!"
    },
    "TwitchRaid": {
        "header": "Incoming Raid!",
        "subtitle": "%username% is raiding with %viewers% viewers!"
    },
    "TwitchModiversary": {
        "header": "Modiversary!",
        "subtitle": "%username% has been a mod for %months% months!"
    },
    "YouTubeSuperChat": {
        "header": "Super Chat!",
        "subtitle": "%username% sent %amount%!"
    },
    "YouTubeSuperSticker": {
        "header": "Super Sticker!",
        "subtitle": "%username% sent a sticker!"
    },
    "YouTubeGiftReceived": {
        "header": "Gift Membership!",
        "subtitle": "%gifter% gifted a membership!"
    },
    "YouTubeNewSponsor": {
        "header": "New Sponsor!",
        "subtitle": "%username% became a sponsor!"
    },
    "YouTubeNewSubscriber": {
        "header": "New Subscriber!",
        "subtitle": "%username% subscribed to the channel!"
    },
    "KickFollow": {
        "header": "New Follower!",
        "subtitle": "%username% followed on Kick!"
    },
    "KickSubscription": {
        "header": "New Sub!",
        "subtitle": "%username% subscribed on Kick!"
    },
    "KickResubscription": {
        "header": "%months% Month Resub!",
        "subtitle": "%username% resubbed for %months% months!"
    },
    "KickMassGiftSubscription": {
        "header": "Gift Subs!",
        "subtitle": "%username% gifted subscriptions!"
    },
    "KofiDonation": {
        "header": "Ko-fi Donation!",
        "subtitle": "%from% donated %amount% %currency%!"
    },
    "KofiSubscription": {
        "header": "Ko-fi Member!",
        "subtitle": "%from% subscribed on Ko-fi!"
    },
    "KofiResubscription": {
        "header": "Ko-fi Resub!",
        "subtitle": "%from% resubscribed with %tier%!"
    },
    "KofiGiftPurchase": {
        "header": "Ko-fi Gift!",
        "subtitle": "%from% purchased a gift!"
    },
    "KofiShopOrder": {
        "header": "Shop Order!",
        "subtitle": "%from% ordered from the shop!"
    },
    "FourthwallDonation": {
        "header": "Fourthwall Donation!",
        "subtitle": "%from% donated %amount% %currency%!"
    },
    "FourthwallSubscriptionPurchased": {
        "header": "Fourthwall Sub!",
        "subtitle": "%from% purchased a subscription!"
    },
    "FourthwallGiftPurchase": {
        "header": "Fourthwall Gift!",
        "subtitle": "%from% purchased a gift!"
    },
    "FourthwallOrderPlaced": {
        "header": "Fourthwall Order!",
        "subtitle": "%from% placed an order!"
    },
    "FourthwallThankYouSent": {
        "header": "Thank You!",
        "subtitle": "%from% sent a thank you!"
    },
    "PatreonPledgeCreated": {
        "header": "New Patron!",
        "subtitle": "%from% pledged %amount%!"
    },
    "StreamlabsDonation": {
        "header": "Donation!",
        "subtitle": "%from% donated %amount% %currency%!"
    },
    "StreamElementsTip": {
        "header": "Tip!",
        "subtitle": "%from% tipped %amount%!"
    }
}

Copy Template

For the PS5 Trophy theme, you can customize the trophy color and image:

Simple Trophy Color

{
    "TwitchFollow": {
        "header": "New Follower!",
        "subtitle": "%username% followed!",
        "trophyColor": "bronze"
    },
    "TwitchSub": {
        "header": "New Subscriber!",
        "subtitle": "%username% subscribed!",
        "trophyColor": "gold",
        "customImage": "https://example.com/my-custom-image.png"
    }
}

Conditional Trophy Colors

You can set trophy colors based on variable values using rules:

Based on Bits (for Cheers)

{
    "TwitchCheer": {
        "header": "%bits% Bits!",
        "subtitle": "%username% cheered!",
        "trophyColor": {
            "variable": "bits",
            "rules": [
                { "min": 10000, "color": "platinum" },
                { "min": 5000, "color": "gold" },
                { "min": 1000, "color": "silver" },
                { "default": "bronze" }
            ]
        }
    }
}

Based on Sub Tier

{
    "TwitchSub": {
        "header": "New Sub!",
        "subtitle": "%username% subscribed with %tiertext%!",
        "trophyColor": {
            "variable": "tiertext",
            "rules": [
                { "equals": "Tier 3", "color": "platinum" },
                { "equals": "Tier 2", "color": "gold" },
                { "equals": "Tier 1", "color": "silver" },
                { "equals": "Prime", "color": "bronze" },
                { "default": "bronze" }
            ]
        }
    }
}

Based on Raid Viewers

{
    "TwitchRaid": {
        "header": "Incoming Raid!",
        "subtitle": "%username% raided with %viewers% viewers!",
        "trophyColor": {
            "variable": "viewers",
            "rules": [
                { "min": 1000, "color": "platinum" },
                { "min": 100, "color": "gold" },
                { "min": 25, "color": "silver" },
                { "default": "bronze" }
            ]
        }
    }
}

Based on Mod Tenure (Modiversary)

{
    "TwitchModiversary": {
        "header": "Modiversary!",
        "subtitle": "%username% — %months% months as mod!",
        "trophyColor": {
            "variable": "months",
            "rules": [
                { "min": 24, "color": "platinum" },
                { "min": 12, "color": "gold" },
                { "min": 6, "color": "silver" },
                { "default": "bronze" }
            ]
        }
    }
}

Conditional Header & Subtitle

You can also make the header and subtitle change based on values:

Based on Bits Amount

{
    "TwitchCheer": {
        "header": {
            "variable": "bits",
            "rules": [
                { "min": 10000, "text": "MASSIVE BIT BOMB!" },
                { "min": 1000, "text": "Huge Cheer!" },
                { "min": 100, "text": "Nice Cheer!" },
                { "default": "Thanks for the bits!" }
            ]
        },
        "subtitle": {
            "variable": "bits",
            "rules": [
                { "min": 10000, "text": "%username% dropped %bits% bits! INSANE!" },
                { "min": 1000, "text": "%username% cheered %bits% bits!" },
                { "default": "%username% cheered %bits% bits!" }
            ]
        },
        "trophyColor": {
            "variable": "bits",
            "rules": [
                { "min": 10000, "color": "platinum" },
                { "min": 1000, "color": "gold" },
                { "min": 100, "color": "silver" },
                { "default": "bronze" }
            ]
        }
    }
}

Based on Sub Tier

{
    "TwitchSub": {
        "header": {
            "variable": "tiertext",
            "rules": [
                { "equals": "Tier 3", "text": "LEGENDARY SUB!" },
                { "equals": "Tier 2", "text": "Epic Subscriber!" },
                { "equals": "Tier 1", "text": "New Subscriber!" },
                { "equals": "Prime", "text": "Prime Gaming!" },
                { "default": "New Subscriber!" }
            ]
        },
        "subtitle": "%username% subscribed with %tiertext%!",
        "trophyColor": {
            "variable": "tiertext",
            "rules": [
                { "equals": "Tier 3", "color": "platinum" },
                { "equals": "Tier 2", "color": "gold" },
                { "equals": "Tier 1", "color": "silver" },
                { "equals": "Prime", "color": "bronze" },
                { "default": "bronze" }
            ]
        }
    }
}

Rule Types

Rule	Description	Example (color)	Example (text)
"min": number	Value must be >= this number	{ "min": 1000, "color": "gold" }	{ "min": 1000, "text": "Huge!" }
"equals": value	Value must equal exactly	{ "equals": "Prime", "color": "bronze" }	{ "equals": "Prime", "text": "Prime Sub!" }
"default"	Fallback if no other rules match	{ "default": "bronze" }	{ "default": "Thanks!" }

Trophy Colors

Color	Sound
bronze	Default trophy sound
silver	Default trophy sound
gold	Default trophy sound
platinum	Platinum trophy sound

For the Xbox Achievement theme, you can customize the gamerscore, isRare, and themeColor:

Simple Theme Color

{
    "TwitchFollow": {
        "header": "%username% Followed!",
        "gamerscore": "25",
        "themeColor": "blue"
    },
    "TwitchSub": {
        "header": "%username% Subscribed!",
        "gamerscore": "100",
        "isRare": true,
        "themeColor": "purple"
    }
}

Conditional Theme Colors

You can set theme colors based on variable values using rules (same format as PS5 trophy colors):

Based on Bits

{
    "TwitchCheer": {
        "header": "%bits% Bits!",
        "gamerscore": "50",
        "themeColor": {
            "variable": "bits",
            "rules": [
                { "min": 10000, "color": "purple" },
                { "min": 5000, "color": "pink" },
                { "min": 1000, "color": "blue" },
                { "default": "green" }
            ]
        }
    }
}

Based on Sub Tier

{
    "TwitchSub": {
        "header": "New Sub!",
        "gamerscore": "100",
        "themeColor": {
            "variable": "tiertext",
            "rules": [
                { "equals": "Tier 3", "color": "purple" },
                { "equals": "Tier 2", "color": "blue" },
                { "equals": "Tier 1", "color": "green" },
                { "equals": "Prime", "color": "yellow" },
                { "default": "green" }
            ]
        }
    }
}

Available Colors

Color	Text Color	Description
green	White	Default Xbox green
blue	White	Xbox blue
pink	White	Vibrant pink
yellow	Black	Bright yellow
orange	White	Warm orange
purple	White	Rich purple
brown	White	Earthy brown
black	White	Dark black
white	Black	Clean white (icons inverted)
red	White	Vibrant red
grey	White	Neutral grey
coral	White	Warm coral/salmon
lightblue	White	Sky blue
darkblue	White	Deep navy blue

For the RPG Quest theme, you can customize the questRarity and title fields. This theme uses a fantasy RPG aesthetic with rarity-based colors.

Simple Quest Rarity

{
    "TwitchFollow": {
        "header": "Quest Update",
        "title": "%username%",
        "subtitle": "Has joined the party!",
        "questRarity": "common"
    },
    "TwitchSub": {
        "header": "New Ally!",
        "title": "%username%",
        "subtitle": "Pledged allegiance!",
        "questRarity": "rare"
    }
}

Conditional Quest Rarity

You can set quest rarity based on variable values using rules:

Based on Bits (for Cheers)

{
    "TwitchCheer": {
        "header": "Treasure Received!",
        "title": "%username%",
        "subtitle": "Donated %bits% gold coins!",
        "questRarity": {
            "variable": "bits",
            "rules": [
                { "min": 10000, "rarity": "legendary" },
                { "min": 1000, "rarity": "epic" },
                { "min": 100, "rarity": "rare" },
                { "min": 10, "rarity": "uncommon" },
                { "default": "common" }
            ]
        }
    }
}

Based on Sub Tier

{
    "TwitchSub": {
        "header": {
            "variable": "tiertext",
            "rules": [
                { "equals": "Tier 3", "text": "Legendary Ally!" },
                { "equals": "Tier 2", "text": "Epic Warrior!" },
                { "equals": "Tier 1", "text": "New Companion!" },
                { "equals": "Prime", "text": "Royal Decree!" },
                { "default": "New Ally!" }
            ]
        },
        "title": "%username%",
        "subtitle": "Pledged allegiance with %tiertext%!",
        "questRarity": {
            "variable": "tiertext",
            "rules": [
                { "equals": "Tier 3", "rarity": "legendary" },
                { "equals": "Tier 2", "rarity": "epic" },
                { "equals": "Tier 1", "rarity": "rare" },
                { "equals": "Prime", "rarity": "uncommon" },
                { "default": "uncommon" }
            ]
        }
    }
}

Based on Resub Months

{
    "TwitchReSub": {
        "header": {
            "variable": "months",
            "rules": [
                { "min": 48, "text": "Legendary Hero!" },
                { "min": 24, "text": "Epic Warrior!" },
                { "min": 12, "text": "Veteran Knight!" },
                { "min": 6, "text": "Trusted Ally!" },
                { "default": "Loyal Companion!" }
            ]
        },
        "title": "%username%",
        "subtitle": "%months% moons of loyalty!",
        "questRarity": {
            "variable": "months",
            "rules": [
                { "min": 48, "rarity": "legendary" },
                { "min": 24, "rarity": "epic" },
                { "min": 12, "rarity": "rare" },
                { "min": 6, "rarity": "uncommon" },
                { "default": "common" }
            ]
        }
    }
}

Quest Rarity Levels

Rarity	Color	Sound	Animation
common	Gold (#d4af37)	Default quest sound	Standard slide-in
uncommon	Green (#32cd32)	Default quest sound	Standard slide-in
rare	Blue (#4169e1)	Default quest sound	Standard slide-in
epic	Purple (#9932cc)	Default quest sound	Pulse glow effect
legendary	Orange (#ff8c00)	Legendary quest sound	Shimmer effect

RPG Quest Fields

Field	Description	Example
header	Top banner text (e.g., "Quest Update")	"header": "New Ally!"
title	Main large text (usually username)	"title": "%username%"
subtitle	Description text below title	"subtitle": "Has joined the party!"
questRarity	Rarity level (affects color & effects)	"questRarity": "legendary"

The Luxury theme features an elegant, minimalist design with gold gradient accents. Perfect for a sophisticated, high-end streaming aesthetic.

Simple Luxury Tier

{
    "TwitchFollow": {
        "header": "New Follower",
        "title": "%username%",
        "subtitle": "Has joined the community",
        "luxuryTier": "gold"
    },
    "TwitchSub": {
        "header": "New Subscriber",
        "title": "%username%",
        "subtitle": "Subscribed with elegance",
        "luxuryTier": "platinum"
    }
}

Conditional Luxury Tiers

You can set luxury tiers based on variable values using rules:

Based on Bits (for Cheers)

{
    "TwitchCheer": {
        "header": "Bits Received",
        "title": "%username%",
        "subtitle": "Cheered %bits% bits",
        "luxuryTier": {
            "variable": "bits",
            "rules": [
                { "min": 10000, "tier": "diamond" },
                { "min": 5000, "tier": "platinum" },
                { "min": 1000, "tier": "gold" },
                { "min": 100, "tier": "rosegold" },
                { "default": "gold" }
            ]
        }
    }
}

Based on Sub Tier

{
    "TwitchSub": {
        "header": {
            "variable": "tiertext",
            "rules": [
                { "equals": "Tier 3", "text": "Elite Membership" },
                { "equals": "Tier 2", "text": "Premium Membership" },
                { "equals": "Tier 1", "text": "New Subscriber" },
                { "equals": "Prime", "text": "Prime Member" },
                { "default": "New Subscriber" }
            ]
        },
        "title": "%username%",
        "subtitle": "Subscribed with %tiertext%",
        "luxuryTier": {
            "variable": "tiertext",
            "rules": [
                { "equals": "Tier 3", "tier": "diamond" },
                { "equals": "Tier 2", "tier": "platinum" },
                { "equals": "Tier 1", "tier": "gold" },
                { "equals": "Prime", "tier": "rosegold" },
                { "default": "gold" }
            ]
        }
    }
}

Based on Resub Months

{
    "TwitchReSub": {
        "header": {
            "variable": "months",
            "rules": [
                { "min": 48, "text": "Legendary Patron" },
                { "min": 24, "text": "Distinguished Member" },
                { "min": 12, "text": "Esteemed Supporter" },
                { "min": 6, "text": "Valued Member" },
                { "default": "Resubscription" }
            ]
        },
        "title": "%username%",
        "subtitle": "%months% months of support",
        "luxuryTier": {
            "variable": "months",
            "rules": [
                { "min": 48, "tier": "diamond" },
                { "min": 24, "tier": "platinum" },
                { "min": 12, "tier": "gold" },
                { "default": "rosegold" }
            ]
        }
    }
}

Luxury Tier Levels

Tier	Color Scheme
gold	Warm gold gradient (#bf953f → #fcf6ba)
platinum	Silver/white gradient (#c0c0c0 → #ffffff)
diamond	Cyan/blue sparkle (#4fc3f7 → #e1f5fe)
rosegold	Pink/rose gradient (#b76e79 → #f4d4d8)
emerald	Green gradient (#2e7d32 → #a5d6a7)
ruby	Red gradient (#c62828 → #ffcdd2)
sapphire	Deep blue gradient (#1565c0 → #bbdefb)
amethyst	Purple gradient (#7b1fa2 → #e1bee7)

Sound Options

The Luxury theme uses a single sound for all alerts, selectable in the customizer:

• default1 - Elegant Chime 1
• default2 - Elegant Chime 2
• default3 - Elegant Chime 3

Luxury Theme Fields

Field	Description	Example
header	Small caps text at top	"header": "New Follower"
title	Large main text (usually username)	"title": "%username%"
subtitle	Small text below divider	"subtitle": "Has joined the community"
luxuryTier	Tier level (affects color scheme)	"luxuryTier": "diamond"

The GTA V theme features the iconic "Mission Passed" style from Grand Theft Auto V. You can customize the header and subtitle text colors using headerColor and subtitleColor.

Simple Color Customization

{
    "TwitchFollow": {
        "header": "FOLLOWER +",
        "subtitle": "%username%",
        "headerColor": "#c9a227",
        "subtitleColor": "#ffffff"
    },
    "TwitchSub": {
        "header": "SUBSCRIPTION +",
        "subtitle": "%username% (%tiertext%)",
        "headerColor": "#00ff00",
        "subtitleColor": "#ffffff"
    }
}

Conditional Header Colors

You can set header colors based on variable values using rules:

Based on Bits (for Cheers)

{
    "TwitchCheer": {
        "header": {
            "variable": "bits",
            "rules": [
                { "min": 10000, "text": "LEGENDARY HEIST!" },
                { "min": 5000, "text": "BIG SCORE!" },
                { "min": 1000, "text": "NICE HAUL!" },
                { "default": "CHEERS +" }
            ]
        },
        "subtitle": "%username% (%bits%)",
        "headerColor": {
            "variable": "bits",
            "rules": [
                { "min": 10000, "color": "#ffd700" },
                { "min": 5000, "color": "#00ff00" },
                { "min": 1000, "color": "#4cc9f0" },
                { "default": "#c9a227" }
            ]
        },
        "subtitleColor": "#ffffff"
    }
}

Based on Sub Tier

{
    "TwitchSub": {
        "header": {
            "variable": "tiertext",
            "rules": [
                { "equals": "Tier 3", "text": "VIP MEMBERSHIP!" },
                { "equals": "Tier 2", "text": "PREMIUM ACCESS!" },
                { "equals": "Tier 1", "text": "SUBSCRIPTION +" },
                { "equals": "Prime", "text": "PRIME TIME!" },
                { "default": "SUBSCRIPTION +" }
            ]
        },
        "subtitle": "%username% (%tiertext%)",
        "headerColor": {
            "variable": "tiertext",
            "rules": [
                { "equals": "Tier 3", "color": "#ffd700" },
                { "equals": "Tier 2", "color": "#00ff00" },
                { "equals": "Tier 1", "color": "#c9a227" },
                { "equals": "Prime", "color": "#9146ff" },
                { "default": "#c9a227" }
            ]
        }
    }
}

Based on Resub Months

{
    "TwitchReSub": {
        "header": "RESUB +",
        "subtitle": "%username% resubbed for %months% months!",
        "headerColor": "#c9a227",
        "subtitleColor": "#ffffff"
    },
    "TwitchGiftedSub": {
        "header": "GIFT SUB +",
        "subtitle": "%username% gifted a sub to %recipient%!",
        "headerColor": "#c9a227",
        "subtitleColor": "#ffffff"
    },
    "TwitchRaid": {
        "header": "RAID +",
        "subtitle": "%username% (%viewers% viewers)",
        "headerColor": "#c9a227",
        "subtitleColor": "#ffffff"
    },
    "TwitchModiversary": {
        "header": "MODIVERSARY +",
        "subtitle": "%username% — %months% months as mod",
        "headerColor": "#c9a227",
        "subtitleColor": "#ffffff"
    }
}

GTA V Theme Fields

Field	Description	Example
header	Large title text (e.g., "MISSION PASSED")	"header": "RESPECT +"
subtitle	Smaller text below the header	"subtitle": "%username%"
headerColor	Color of the header text (hex code)	"headerColor": "#c9a227"
subtitleColor	Color of the subtitle text (hex code)	"subtitleColor": "#ffffff"

Suggested Colors

Color	Hex Value	Description
GTA Gold (Default)	#c9a227	Classic GTA mission passed gold
Bright Gold	#ffd700	For legendary/high-value events
Green	#00ff00	Money/success color
Cyan	#4cc9f0	Cool accent color
Twitch Purple	#9146ff	For Prime subs
White	#ffffff	Default subtitle color

The ESports Classic theme features an aggressive, competitive esports design with angled elements, bold colors, and a carbon fiber texture. Perfect for gaming streams with a competitive edge.

Simple Accent Color

{
    "TwitchFollow": {
        "header": "NEW FOLLOWER",
        "title": "%username%",
        "value": "",
        "esportsColor": "red"
    },
    "TwitchSub": {
        "header": "SUBSCRIBER",
        "title": "%username%",
        "value": "TIER 1",
        "esportsColor": "blue"
    }
}

Conditional Accent Colors

You can set accent colors based on variable values using rules:

Based on Bits (for Cheers)

{
    "TwitchCheer": {
        "header": "BITS RECEIVED",
        "title": "%username%",
        "value": "%bits% BITS",
        "esportsColor": {
            "variable": "bits",
            "rules": [
                { "min": 10000, "color": "purple" },
                { "min": 5000, "color": "blue" },
                { "min": 1000, "color": "green" },
                { "min": 100, "color": "yellow" },
                { "default": "red" }
            ]
        }
    }
}

Based on Sub Tier

{
    "TwitchSub": {
        "header": {
            "variable": "tiertext",
            "rules": [
                { "equals": "Tier 3", "text": "TIER 3 SUB!" },
                { "equals": "Tier 2", "text": "TIER 2 SUB!" },
                { "equals": "Tier 1", "text": "NEW SUB!" },
                { "equals": "Prime", "text": "PRIME SUB!" },
                { "default": "SUBSCRIBER" }
            ]
        },
        "title": "%username%",
        "value": "%tiertext%",
        "esportsColor": {
            "variable": "tiertext",
            "rules": [
                { "equals": "Tier 3", "color": "purple" },
                { "equals": "Tier 2", "color": "blue" },
                { "equals": "Tier 1", "color": "green" },
                { "equals": "Prime", "color": "cyan" },
                { "default": "red" }
            ]
        }
    }
}

Based on Raid Viewers

{
    "TwitchRaid": {
        "header": {
            "variable": "viewers",
            "rules": [
                { "min": 500, "text": "MEGA RAID!" },
                { "min": 200, "text": "MASSIVE RAID!" },
                { "min": 50, "text": "RAID INCOMING!" },
                { "default": "RAIDERS!" }
            ]
        },
        "title": "%username%",
        "value": "%viewers% RAIDERS",
        "esportsColor": {
            "variable": "viewers",
            "rules": [
                { "min": 500, "color": "purple" },
                { "min": 200, "color": "blue" },
                { "min": 50, "color": "green" },
                { "default": "red" }
            ]
        }
    }
}

Custom Background & Accent Colors

You can customize the background and accent colors using hex color codes:

{
    "TwitchFollow": {
        "header": "NEW FOLLOWER",
        "title": "%username%",
        "value": "",
        "esportsColor": "red",
        "esportsBgColor": "#111111",
        "esportsAccentColor": "#ff4655"
    }
}

Available Preset Colors

Color	Hex Value	Description
red	#ff4655	Default esports red (Valorant-style)
blue	#00d4ff	Bright cyan blue
green	#00ff87	Neon green
yellow	#ffd700	Gold yellow
orange	#ff8c00	Warm orange
purple	#9d4edd	Vibrant purple
pink	#ff69b4	Hot pink
cyan	#00ffff	Bright cyan
white	#ffffff	Clean white

ESports Classic Fields

Field	Description	Example
header	Small header text with bolt icon	"header": "NEW FOLLOWER"
title	Large main text (usually username)	"title": "%username%"
value	Right-side value panel (bits, months, etc.)	"value": "%bits% BITS"
esportsColor	Accent color preset name	"esportsColor": "purple"
esportsBgColor	Custom background color (hex)	"esportsBgColor": "#1a1a2e"
esportsAccentColor	Custom accent color (hex)	"esportsAccentColor": "#00d4ff"

The Modern theme features a clean, minimalist design with a rotating mesh gradient background, rounded corners, and smooth animations. Perfect for a contemporary, professional streaming aesthetic.

Simple Color Scheme

{
    "TwitchFollow": {
        "header": "New Follower",
        "title": "%username%",
        "subtitle": "",
        "colorScheme": "default"
    },
    "TwitchSub": {
        "header": "Subscriber",
        "title": "%username%",
        "subtitle": "Tier 1",
        "colorScheme": "ocean"
    }
}

Conditional Color Schemes

You can set color schemes based on variable values using rules:

Based on Bits (for Cheers)

{
    "TwitchCheer": {
        "header": "Bits Received",
        "title": "%username%",
        "subtitle": "%bits% bits",
        "colorScheme": {
            "variable": "bits",
            "rules": [
                { "min": 10000, "scheme": "sunset" },
                { "min": 5000, "scheme": "rose" },
                { "min": 1000, "scheme": "ocean" },
                { "default": "default" }
            ]
        }
    }
}

Based on Sub Tier

{
    "TwitchSub": {
        "header": "Subscriber",
        "title": "%username%",
        "subtitle": "%tiertext%",
        "colorScheme": {
            "variable": "tiertext",
            "rules": [
                { "equals": "Tier 3", "scheme": "sunset" },
                { "equals": "Tier 2", "scheme": "ocean" },
                { "equals": "Prime", "scheme": "forest" },
                { "default": "default" }
            ]
        }
    }
}

Available Color Schemes

Scheme	Colors	Description
default	Indigo/Pink/Cyan	Default vibrant gradient
ocean	Blue/Teal/Cyan	Cool ocean tones
sunset	Orange/Pink/Purple	Warm sunset colors
forest	Green/Emerald/Teal	Natural green tones
midnight	Purple/Blue/Indigo	Dark mode with purple accents
rose	Pink/Rose/Red	Romantic pink tones
monochrome	Gray tones	Neutral grayscale

Show Avatars Option

The Modern theme supports displaying user avatars instead of icons. Enable this in the Preset Options when selecting the Modern theme in the customizer.

When enabled, the icon area will display the user's profile picture (when available) instead of the default SVG icons.

Modern Theme Fields

Field	Description	Example
header	Small uppercase text at top	"header": "New Follower"
title	Large main text (usually username)	"title": "%username%"
subtitle	Colored text below title	"subtitle": "Month 10"
colorScheme	Background gradient color scheme	"colorScheme": "ocean"

Use these variables in your text - they will be replaced with actual values when the alert is shown.

Common Variables

Variable	Description	Available In
%username%	The user's display name	All events
%userid%	The user's ID	All events

Twitch Variables

Variable	Description	Available In
%bits%	Number of bits cheered	TwitchCheer
%tier%	Subscription tier number (1, 2, or 3)	TwitchSub, TwitchReSub, TwitchGiftedSub
%tiertext%	Tier text (Tier 1, Tier 2, Tier 3, or Prime)	TwitchSub, TwitchReSub
%isprime%	"true" or "false" - whether sub is Prime	TwitchSub, TwitchReSub
%months%	Months (resub streak or mod tenure)	TwitchReSub, TwitchModiversary
%recipient%	Gift sub recipient's name	TwitchGiftedSub
%viewers%	Number of raid viewers	TwitchRaid
%months%	Months as a moderator	TwitchModiversary
%message%	User's message	TwitchCheer, TwitchSub, TwitchReSub

YouTube Variables

Variable	Description	Available In
%amount%	Super Chat/Sticker amount	YouTubeSuperChat, YouTubeSuperSticker
%gifter%	Name of the person who gifted	YouTubeGiftReceived

Kick Variables

Variable	Description	Available In
%from%	User's display name	All Kick events
%login%	User's login name	KickFollow, KickMassGiftSubscription
%months%	Subscription months	KickResubscription

Ko-fi Variables

Variable	Description	Available In
%from%	Supporter's name	All Ko-fi events
%amount%	Donation amount	KofiDonation
%currency%	Currency code (USD, EUR, etc.)	KofiDonation
%tier%	Subscription tier	KofiSubscription, KofiResubscription
%items%	Number of items ordered	KofiShopOrder
%itemcount%	Number of items (alias for %items%)	KofiShopOrder
%message%	User's message	KofiDonation, KofiSubscription, KofiResubscription, KofiShopOrder

Streamlabs Variables

Variable	Description	Available In
%from%	Donor's name	StreamlabsDonation
%amount%	Donation amount	StreamlabsDonation
%currency%	Currency code	StreamlabsDonation
%message%	Donation message	StreamlabsDonation

StreamElements Variables

Variable	Description	Available In
%from%	Tipper's name	StreamElementsTip
%amount%	Tip amount	StreamElementsTip
%currency%	Currency code	StreamElementsTip
%message%	Tip message	StreamElementsTip

Fourthwall Variables

Variable	Description	Available In
%from%	Buyer's name	All Fourthwall events
%amount%	Donation amount	FourthwallDonation
%currency%	Currency code	FourthwallDonation
%items%	Number of items	FourthwallGiftPurchase, FourthwallOrderPlaced
%itemcount%	Number of items (alias)	FourthwallGiftPurchase, FourthwallOrderPlaced
%message%	Donation message	FourthwallDonation

Patreon Variables

Variable	Description	Available In
%from%	Patron's name	PatreonPledgeCreated
%amount%	Pledge amount	PatreonPledgeCreated
%tier%	Tier name	PatreonPledgeCreated

You can set different text for each theme by nesting your customizations under the theme name:

{
    "ps5trophy": {
        "TwitchFollow": {
            "header": "Trophy Unlocked!",
            "subtitle": "%username% earned the Follow trophy!"
        }
    },
    "xboxachievement": {
        "TwitchFollow": {
            "header": "%username% Followed!",
            "gamerscore": "10"
        }
    },
    "rpgquest": {
        "TwitchFollow": {
            "header": "Quest Update",
            "title": "%username%",
            "subtitle": "Has joined the party!",
            "questRarity": "common"
        }
    },
    "luxury": {
        "TwitchFollow": {
            "header": "New Follower",
            "title": "%username%",
            "subtitle": "Has joined the community",
            "luxuryTier": "gold"
        }
    },
    "esportsclassic": {
        "TwitchFollow": {
            "header": "NEW FOLLOWER",
            "title": "%username%",
            "value": "",
            "esportsColor": "red"
        }
    },
    "modern": {
        "TwitchFollow": {
            "header": "New Follower",
            "title": "%username%",
            "subtitle": "",
            "colorScheme": "default"
        }
    }
}

You can combine multiple conditions using the conditions array. All conditions must be true for the rule to match (AND logic).

Example: Tier + Months Combined

{
    "TwitchReSub": {
        "subtitle": {
            "rules": [
                {
                    "conditions": [
                        { "variable": "months", "min": 12 },
                        { "variable": "tiertext", "equals": "Tier 3" }
                    ],
                    "text": "A year of Tier 3 support! You are incredible!"
                },
                {
                    "conditions": [
                        { "variable": "months", "min": 12 },
                        { "variable": "tiertext", "equals": "Tier 2" }
                    ],
                    "text": "A year of Tier 2! Amazing dedication!"
                },
                {
                    "conditions": [
                        { "variable": "months", "min": 6 },
                        { "variable": "isprime", "equals": "true" }
                    ],
                    "text": "6+ months of Prime support!"
                },
                { "min": 12, "text": "One year anniversary!" },
                { "default": "Thanks for %months% months!" }
            ],
            "variable": "months"
        }
    }
}

Example: Bits + Message Combined

{
    "TwitchCheer": {
        "header": {
            "rules": [
                {
                    "conditions": [
                        { "variable": "bits", "min": 1000 },
                        { "variable": "bits", "max": 4999 }
                    ],
                    "text": "Big Cheerer!"
                },
                {
                    "conditions": [
                        { "variable": "bits", "min": 5000 }
                    ],
                    "text": "MEGA CHEERER!"
                },
                { "default": "Thanks for the bits!" }
            ]
        }
    }
}

Condition Types

Condition	Description	Example
min	Value must be greater than or equal to	{ "variable": "bits", "min": 1000 }
max	Value must be less than or equal to	{ "variable": "months", "max": 11 }
equals	Value must exactly match (case-insensitive for strings)	{ "variable": "tiertext", "equals": "Tier 3" }

The Hacker theme features a terminal-style design with typing animations, ASCII art banners, and a retro CRT aesthetic. When an event triggers, a terminal window opens and a command is "typed" followed by ASCII art displaying the event type.

Simple Terminal Color

{
    "TwitchFollow": {
        "title": "%username%",
        "subtitle": "has connected to the network",
        "hackerColor": "green"
    },
    "TwitchSub": {
        "title": "%username%",
        "subtitle": "subscribed with %tiertext%",
        "hackerColor": "cyan"
    }
}

Conditional Terminal Colors

You can set terminal colors based on variable values using rules:

Based on Bits (for Cheers)

{
    "TwitchCheer": {
        "title": "%username%",
        "subtitle": "transferred %bits% bits",
        "hackerColor": {
            "variable": "bits",
            "rules": [
                { "min": 10000, "color": "red" },
                { "min": 5000, "color": "purple" },
                { "min": 1000, "color": "cyan" },
                { "min": 100, "color": "amber" },
                { "default": "green" }
            ]
        }
    }
}

Based on Sub Tier

{
    "TwitchSub": {
        "title": "%username%",
        "subtitle": {
            "variable": "tiertext",
            "rules": [
                { "equals": "Tier 3", "text": "subscribed with TIER 3 access" },
                { "equals": "Tier 2", "text": "subscribed with TIER 2 access" },
                { "equals": "Tier 1", "text": "subscribed with TIER 1 access" },
                { "equals": "Prime", "text": "subscribed with PRIME access" },
                { "default": "subscribed to the network" }
            ]
        },
        "hackerColor": {
            "variable": "tiertext",
            "rules": [
                { "equals": "Tier 3", "color": "purple" },
                { "equals": "Tier 2", "color": "cyan" },
                { "equals": "Tier 1", "color": "green" },
                { "equals": "Prime", "color": "amber" },
                { "default": "green" }
            ]
        }
    }
}

Based on Resub Months

{
    "TwitchReSub": {
        "title": "%username%",
        "subtitle": {
            "variable": "months",
            "rules": [
                { "min": 48, "text": "VETERAN STATUS: %months% months connected" },
                { "min": 24, "text": "ELITE STATUS: %months% months connected" },
                { "min": 12, "text": "TRUSTED STATUS: %months% months connected" },
                { "default": "resubscribed for %months% months" }
            ]
        },
        "hackerColor": {
            "variable": "months",
            "rules": [
                { "min": 48, "color": "red" },
                { "min": 24, "color": "purple" },
                { "min": 12, "color": "cyan" },
                { "default": "green" }
            ]
        }
    }
}

Available Terminal Colors

Color	Description
green	Classic Matrix green (default)
cyan	Bright cyan/teal
amber	Retro amber terminal
red	Red alert style
purple	Vibrant purple
blue	Cool blue
pink	Hot pink
white	Clean white

Hacker Theme Fields

Field	Description	Example
title	Username displayed in the terminal	"title": "%username%"
subtitle	Description text below username	"subtitle": "has connected to the network"
hackerColor	Terminal color scheme	"hackerColor": "cyan"

Preset Options (Customizer)

• Terminal Position - Top, Middle, or Bottom of screen
• Terminal Color - Default color for all alerts
• Alert Sound - Terminal Beep, Keyboard Click, or System Alert
• Scanlines Effect - Add retro CRT scanlines overlay

ASCII Art Events

The theme includes unique ASCII art banners for each event type:

• NEW FOLLOWER - For follows
• SUBSCRIBER - For new subscriptions
• RESUB - For resubscriptions
• DONATION - For Ko-fi, Fourthwall, Streamlabs donations
• TIP - For StreamElements tips
• CHEERS - For Twitch bits
• RAID - For incoming raids
• MODIVERSARY - For mod anniversaries
• GIFT - For gift subscriptions
• SUPERCHAT - For YouTube Super Chats
• MEMBER - For YouTube memberships
• ORDER - For shop orders
• PATRON - For Patreon pledges
• THANK YOU - For thank you messages

The GTA V theme recreates the iconic "Mission Passed" screen from Grand Theft Auto V. Features the Pricedown font, golden text, and optional green screen flash effect.

Simple Configuration

{
    "TwitchFollow": {
        "header": "MISSION PASSED",
        "subtitle": "%username% has followed!"
    },
    "TwitchSub": {
        "header": "RESPECT +",
        "subtitle": "%username% subscribed!"
    }
}

Conditional Headers

You can change the header text based on variable values:

Based on Bits (for Cheers)

{
    "TwitchCheer": {
        "header": {
            "variable": "bits",
            "rules": [
                { "min": 10000, "text": "HEIST COMPLETE" },
                { "min": 1000, "text": "RESPECT +" },
                { "min": 100, "text": "MISSION PASSED" },
                { "default": "MISSION PASSED" }
            ]
        },
        "subtitle": "%username% cheered %bits% bits!"
    }
}

Based on Raid Viewers

{
    "TwitchRaid": {
        "header": {
            "variable": "viewers",
            "rules": [
                { "min": 500, "text": "HEIST COMPLETE" },
                { "min": 100, "text": "RESPECT +" },
                { "default": "MISSION PASSED" }
            ]
        },
        "subtitle": "%username% raided with %viewers% viewers!"
    }
}

Based on Sub Tier

{
    "TwitchSub": {
        "header": {
            "variable": "tiertext",
            "rules": [
                { "equals": "Tier 3", "text": "HEIST COMPLETE" },
                { "equals": "Tier 2", "text": "RESPECT +" },
                { "equals": "Tier 1", "text": "MISSION PASSED" },
                { "equals": "Prime", "text": "MISSION PASSED" },
                { "default": "MISSION PASSED" }
            ]
        },
        "subtitle": "%username% subscribed with %tiertext%!"
    }
}

GTA V Theme Fields

Field	Description	Example
header	Large golden text (Pricedown font)	"header": "MISSION PASSED"
subtitle	Smaller white text below header	"subtitle": "%username% has followed!"

Suggested Header Text

Text	Suggested Use
MISSION PASSED	Default for most events (follows, basic subs)
RESPECT +	Higher value events (resubs, medium donations)
HEIST COMPLETE	Big events (large donations, raids, Tier 3 subs)
WASTED	Fun alternative for special occasions

Preset Options (Customizer)

• Green Screen Flash - Enable/disable the transparent green flash effect when alerts appear

The Assassin's Creed Origins theme features an Egyptian-inspired quest completion style with animated XP counters. The alert displays a golden eagle background, "QUEST COMPLETED" header, username with decorative lines, and an XP value that animates from 0 to the target value.

Simple XP Value

{
    "TwitchFollow": {
        "header": "QUEST COMPLETED",
        "title": "%username%",
        "xp": 100
    },
    "TwitchSub": {
        "header": "QUEST COMPLETED",
        "title": "%username%",
        "xp": 500
    }
}

Conditional Headers & XP

You can set headers and XP values based on variable values using rules:

Based on Bits (for Cheers)

{
    "TwitchCheer": {
        "header": {
            "variable": "bits",
            "rules": [
                { "min": 10000, "text": "LEGENDARY QUEST" },
                { "min": 5000, "text": "EPIC QUEST" },
                { "min": 1000, "text": "RARE QUEST" },
                { "default": "QUEST COMPLETED" }
            ]
        },
        "title": "%username%",
        "xp": {
            "variable": "bits",
            "rules": [
                { "min": 10000, "text": 10000 },
                { "min": 5000, "text": 5000 },
                { "min": 1000, "text": 1000 },
                { "min": 100, "text": 500 },
                { "default": 100 }
            ]
        }
    }
}

Based on Sub Tier

{
    "TwitchSub": {
        "header": {
            "variable": "tiertext",
            "rules": [
                { "equals": "Tier 3", "text": "LEGENDARY QUEST" },
                { "equals": "Tier 2", "text": "EPIC QUEST" },
                { "equals": "Tier 1", "text": "QUEST COMPLETED" },
                { "equals": "Prime", "text": "QUEST COMPLETED" },
                { "default": "QUEST COMPLETED" }
            ]
        },
        "title": "%username%",
        "xp": {
            "variable": "tiertext",
            "rules": [
                { "equals": "Tier 3", "text": 1500 },
                { "equals": "Tier 2", "text": 1000 },
                { "equals": "Tier 1", "text": 500 },
                { "equals": "Prime", "text": 500 },
                { "default": 500 }
            ]
        }
    }
}

Based on Resub Months

{
    "TwitchReSub": {
        "header": {
            "variable": "months",
            "rules": [
                { "min": 48, "text": "LEGENDARY QUEST" },
                { "min": 24, "text": "EPIC QUEST" },
                { "min": 12, "text": "RARE QUEST" },
                { "default": "QUEST COMPLETED" }
            ]
        },
        "title": "%username%",
        "xp": {
            "variable": "months",
            "rules": [
                { "min": 48, "text": 4800 },
                { "min": 24, "text": 2400 },
                { "min": 12, "text": 1200 },
                { "min": 6, "text": 600 },
                { "default": 250 }
            ]
        }
    }
}

Suggested Header Text

Text	Suggested Use
QUEST COMPLETED	Default for most events (follows, basic subs)
RARE QUEST	Medium value events (resubs 6-12 months, 100+ bits)
EPIC QUEST	Higher value events (resubs 12-24 months, Tier 2 subs)
LEGENDARY QUEST	Big events (large donations, 48+ month resubs, Tier 3 subs)

ACO Theme Fields

Field	Description	Example
header	Golden text at top (e.g., "QUEST COMPLETED")	"header": "LEGENDARY QUEST"
title	Username displayed with decorative lines	"title": "%username%"
xp	XP value that animates from 0	"xp": 500

The iOS Notification theme mimics the notification pop-up style from iOS devices. It features a clean, rounded design with the user's name at the top, message below, and "now" timestamp on the right.

iOS Version Styles

Choose between two iOS styles in the customizer:

Style	Description
ios26	Transparent glass effect with animated shiny border - the modern iOS 26 look
ios18	Classic frosted glass effect - the traditional iOS notification style

Simple Customization

{
    "TwitchFollow": {
        "title": "%username%",
        "subtitle": "Started following you"
    },
    "TwitchSub": {
        "title": "%username%",
        "subtitle": "Subscribed with %tiertext%"
    }
}

Conditional Text

You can set different text based on variable values using rules:

Based on Bits (for Cheers)

{
    "TwitchCheer": {
        "title": "%username%",
        "subtitle": {
            "variable": "bits",
            "rules": [
                { "min": 10000, "text": "Dropped a massive %bits% bits! 🎉" },
                { "min": 1000, "text": "Cheered %bits% bits!" },
                { "min": 100, "text": "Sent %bits% bits" },
                { "default": "Cheered %bits% bits" }
            ]
        }
    }
}

Based on Sub Tier

{
    "TwitchSub": {
        "title": "%username%",
        "subtitle": {
            "variable": "tiertext",
            "rules": [
                { "equals": "Tier 3", "text": "Subscribed at the highest tier! 🌟" },
                { "equals": "Tier 2", "text": "Subscribed with Tier 2" },
                { "equals": "Tier 1", "text": "Just subscribed!" },
                { "equals": "Prime", "text": "Used their Prime sub" },
                { "default": "Subscribed!" }
            ]
        }
    }
}

Based on Resub Months

{
    "TwitchReSub": {
        "title": "%username%",
        "subtitle": {
            "variable": "months",
            "rules": [
                { "min": 48, "text": "4 years of support! 🏆" },
                { "min": 24, "text": "2 years strong! 🎊" },
                { "min": 12, "text": "1 year anniversary! 🎂" },
                { "min": 6, "text": "6 months of loyalty!" },
                { "default": "Resubscribed for %months% months" }
            ]
        }
    }
}

iOS Notification Theme Fields

Field	Description	Example
title	Bold text at top (usually username)	"title": "%username%"
subtitle	Message text below the title	"subtitle": "Started following you"
sound	Custom sound for this event (sound name or full URL)	"sound": "critical"

Available Sounds

You can use these built-in sound names in the sound field:

Sound Name	Description
default	Default iOS notification sound (default for iOS 26)
classic	Classic iOS notification sound (default for iOS Classic)
airdrop	AirDrop received sound
charging	Device charging sound
critical	Critical alert sound
ding	Ding notification sound
facetime-call	FaceTime incoming call
facetime-invite	FaceTime invite sound
homepod	HomePod notification sound
new-email	New email notification
photo-memory	Photo memory sound
startup	Device startup sound

Custom Sounds Per Event

You can set different sounds for different events:

{
    "TwitchFollow": {
        "title": "%username%",
        "subtitle": "Started following you",
        "sound": "default"
    },
    "TwitchCheer": {
        "title": "%username%",
        "subtitle": "Cheered %bits% bits!",
        "sound": "critical"
    },
    "TwitchSub": {
        "title": "%username%",
        "subtitle": "Subscribed!",
        "sound": "facetime-invite"
    }
}

Conditional Sounds

You can also use conditional rules for sounds based on event values:

{
    "TwitchCheer": {
        "title": "%username%",
        "subtitle": "Cheered %bits% bits!",
        "sound": {
            "variable": "bits",
            "rules": [
                { "min": 1000, "sound": "critical" },
                { "min": 100, "sound": "facetime-invite" },
                { "default": "default" }
            ]
        }
    }
}

FirstWord Alerts (User's First Message on the Stream)

The iOS Notification theme supports TwitchFirstWord events, which trigger when a user sends their first message in chat per stream session (Not to be confused with First Chat Message which is for the first message in the channel). You can customize the subtitle based on specific usernames:

{
    "TwitchFirstWord": {
        "title": "%username%",
        "subtitle": {
            "variable": "username",
            "rules": [
                { "equals": "krookediles", "text": "Has come to snap!" },
                { "equals": "playingcatchup", "text": "Has catched up to the stream!" },
                { "equals": "nightbot", "text": "The bot has awakened!" },
                { "default": "Has entered the stream!" }
            ]
        },
        "sound": "ding"
    }
}

This allows you to create personalized welcome messages for specific viewers. The username variable is matched case-insensitively.

Available Variables for TwitchFirstWord

Variable	Description
%username%	The username of the person who sent their first message
%message%	The actual message they sent

The Animus theme is inspired by the Abstergo / Animus interface from the Assassin's Creed franchise. It features 10 visual designs and 10 independent logo animations, all selectable in the Customizer. You can override the three text fields — header, title, and subtitle — using your JSON file.

Basic Example

{
    "animus": {
        "TwitchFollow": {
            "header": "NEW INITIATE",
            "title": "%username%",
            "subtitle": "Has joined the Brotherhood"
        },
        "TwitchSub": {
            "header": "BROTHERHOOD BOND",
            "title": "%username%",
            "subtitle": "Has sworn the Creed"
        },
        "TwitchRaid": {
            "header": "RAID INCOMING",
            "title": "%username%",
            "subtitle": "%viewers% assassins have entered the Animus"
        }
    }
}

Conditional Headers Based on Sub Tier

{
    "animus": {
        "TwitchSub": {
            "header": {
                "variable": "tiertext",
                "rules": [
                    { "equals": "Tier 3", "text": "MASTER ASSASSIN" },
                    { "equals": "Tier 2", "text": "HIDDEN BLADE" },
                    { "equals": "Tier 1", "text": "BROTHERHOOD BOND" },
                    { "equals": "Prime", "text": "PRIME INITIATE" },
                    { "default": "NEW MEMBER" }
                ]
            },
            "title": "%username%",
            "subtitle": {
                "variable": "tiertext",
                "rules": [
                    { "equals": "Tier 3", "text": "Sworn to the Creed at Tier 3" },
                    { "equals": "Tier 2", "text": "Joined the Brotherhood at Tier 2" },
                    { "equals": "Prime", "text": "Prime — Nothing is true" },
                    { "default": "Has joined the Brotherhood" }
                ]
            }
        }
    }
}

Conditional Headers Based on Bits

{
    "animus": {
        "TwitchCheer": {
            "header": {
                "variable": "bits",
                "rules": [
                    { "min": 10000, "text": "LEGENDARY TRIBUTE" },
                    { "min": 5000, "text": "GRAND TRIBUTE" },
                    { "min": 1000, "text": "TRIBUTE RECEIVED" },
                    { "default": "MEMORY FRAGMENT" }
                ]
            },
            "title": "%username%",
            "subtitle": "Offered %bits% bits to the Brotherhood"
        }
    }
}

Conditional Headers Based on Raid Size

{
    "animus": {
        "TwitchRaid": {
            "header": {
                "variable": "viewers",
                "rules": [
                    { "min": 500, "text": "EAGLE'S ARMY" },
                    { "min": 100, "text": "RAID INCOMING" },
                    { "min": 25, "text": "BROTHERHOOD RAID" },
                    { "default": "RAIDERS" }
                ]
            },
            "title": "%username%",
            "subtitle": "%viewers% assassins have entered the Animus"
        }
    }
}

Animus Theme Fields

Field	Description	Example
header	Small caps label at the top (event type label)	"header": "NEW INITIATE"
title	Large main text, usually the username	"title": "%username%"
subtitle	Smaller description text below the title	"subtitle": "Has joined the Brotherhood"

The Companion theme pops a pet up from the bottom left of the screen. It barks (or meows, squeaks or squawks) and a speech bubble pops up with the alert. Pick a Dog (10 breeds), Cat (8 breeds), Bearded Dragon, Bunny, Parrot, Hamster or Axolotl in the Customizer, or let it pick a random pet for every alert. You can override header and subtitle, and you can even swap the pet per event with pet.

Basic Example

{
    "companion": {
        "TwitchFollow": {
            "header": "New Follower",
            "subtitle": "%username% just joined the pack!"
        },
        "TwitchGiftedSub": {
            "header": "Gift Sub",
            "subtitle": "%username% gifted a sub to %recipient%!",
            "pet": "corgi"
        },
        "KofiDonation": {
            "header": "Donation",
            "subtitle": "%username% sent %currency%%amount% in treats!",
            "pet": "cat"
        }
    }
}

Bigger Raids Get a Bigger Dog

{
    "companion": {
        "TwitchRaid": {
            "header": "Incoming Raid",
            "subtitle": "%username% brought %viewers% friends!",
            "pet": {
                "variable": "viewers",
                "rules": [
                    { "min": 100, "text": "german-shepherd" },
                    { "default": "hamster" }
                ]
            }
        }
    }
}

Companion Theme Fields

Field	Description	Example
header	Coloured badge on top of the speech bubble	"header": "New Follower"
subtitle	Text shown in the speech bubble. The username is highlighted automatically.	"subtitle": "%username% just followed!"
pet	Use a different pet for this event. dog and cat use the breed picked in the Customizer, or name a breed directly. Dogs: german-shepherd, golden-retriever, dachshund, labrador, french-bulldog, beagle, husky, corgi, border-collie, pug. Cats: ginger-cat, tabby-cat, black-cat, tuxedo-cat, siamese-cat, british-shorthair, calico-cat, maine-coon. Others: bearded-dragon, bunny, parrot, hamster, axolotl, or random	"pet": "cat"
headerColor	Overrides the accent colour (badge, name highlight and particles)	"headerColor": "#ff4f8b"
subtitleColor	Colour of the bubble text	"subtitleColor": "#241f3a"
sound	Full URL to a sound to play instead of the pet's bark, or "none"	"sound": "https://example.com/woof.mp3"

The Spyro theme brings Spyro the Dragon up from the bottom left. He takes a deep breath and blasts a stream of flame across the screen, and each letter of the alert catches fire as the flames pass over it. Gems then burst out and get collected into a gem counter. In the Customizer you can choose Fire, Blue Fire, Ice or Shadow breath, and turn Sparx, the gem burst and the counter on or off.

Basic Example

{
    "spyro": {
        "TwitchFollow": {
            "header": "New Follower!",
            "subtitle": "%username% joined the adventure!"
        },
        "TwitchRaid": {
            "header": "Raid!",
            "subtitle": "%username% charged in with %viewers% viewers!"
        },
        "TwitchGiftedSub": {
            "header": "Gift Sub!",
            "subtitle": "%username% gifted a sub to %recipient%!",
            "gem": "gold"
        }
    }
}

Conditional Headers Based on Bits

{
    "spyro": {
        "TwitchCheer": {
            "header": {
                "variable": "bits",
                "rules": [
                    { "min": 1000, "text": "Treasure Hoard!" },
                    { "default": "Cheer!" }
                ]
            },
            "subtitle": "%username% cheered %bits% bits!",
            "gem": "purple"
        }
    }
}

Spyro Theme Fields

Field	Description	Example
header	Big chunky header text that gets set alight	"header": "New Follower!"
subtitle	Line underneath. The username is highlighted automatically.	"subtitle": "%username% joined the adventure!"
gem	Colour of the gems that burst out: red, green, blue, gold or purple	"gem": "gold"
headerColor	Colour of the header and the username	"headerColor": "#ffd23f"
subtitleColor	Colour of the subtitle	"subtitleColor": "#ffffff"
sound	Full URL to a sound to play instead of the flame roar, or "none" for silent flames	"sound": "https://example.com/roar.mp3"

The Navi theme is inspired by The Legend of Zelda: Ocarina of Time. Navi swoops in from the bottom left shouting "Hey!", an Ocarina of Time text box opens, and she zips across it lighting up each letter as she passes. Rupees then spill out into a rupee counter and she loops back to wait by the box until it closes. Her glow changes per event like in the game: blue for follows, green for subs, pink for gifts and yellow for raids, with "Watch out!" for raids, "Hello!" and "Look!" for gifts and "Look!" for cheers. She plays the game's own fly-in, flutter and fly-away sounds too.

Basic Example

{
    "navi": {
        "TwitchFollow": {
            "header": "A New Hero",
            "subtitle": "%username% has entered Hyrule!"
        },
        "TwitchRaid": {
            "header": "Watch Out!",
            "subtitle": "%username% brought %viewers% Kokiri with them!",
            "rupee": "purple"
        },
        "TwitchGiftedSub": {
            "header": "Gift Sub",
            "subtitle": "%username% gave %recipient% a Heart Container!",
            "rupee": "gold"
        }
    }
}

Navi Theme Fields

Field	Description	Example
header	Title line at the top of the text box, in Navi's colour	"header": "A New Hero"
subtitle	Message in the text box. The username is highlighted in red like key words in the game.	"subtitle": "%username% has entered Hyrule!"
rupee	Colour of the rupees: green, blue, red, purple, gold or silver	"rupee": "red"
headerColor	Overrides the header colour	"headerColor": "#a8dcff"
subtitleColor	Colour of the message text	"subtitleColor": "#ffffff"
sound	Full URL to a sound to play instead of Navi's first shout	"sound": "https://example.com/hey.mp3"

The Thanos Snap theme recreates the snap from Avengers: Infinity War. The alert appears in gold under the six Infinity Stones, the gauntlet snaps with a flash of light, then the text greys to ash in patches and crumbles away on the wind. The snap is timed from your alert duration, so the dust is always gone by the time the alert ends. You can override header and subtitle.

Basic Example

{
    "thanos-snap": {
        "TwitchFollow": {
            "header": "Inevitable",
            "subtitle": "%username% just followed!"
        },
        "TwitchRaid": {
            "header": "Avengers Assemble",
            "subtitle": "%username% brought %viewers% heroes!"
        },
        "TwitchSub": {
            "header": "Perfectly Balanced",
            "subtitle": "%username% subscribed with %tiertext%!"
        }
    }
}

Thanos Snap Theme Fields

Field	Description	Example
header	Big gold header under the Infinity Stones	"header": "Inevitable"
subtitle	Line underneath. The username is highlighted in purple.	"subtitle": "%username% just followed!"
headerColor	Header colour before it turns to ash	"headerColor": "#f2c94c"
subtitleColor	Subtitle colour before it turns to ash	"subtitleColor": "#ffffff"
sound	Full URL to a sound to play instead of the snap	"sound": "https://example.com/snap.mp3"

The Pokémon theme throws a Poké Ball into the bottom left of the screen. It bursts open and your partner Pokémon appears with its cry, the battle box shows "PIKACHU used THUNDER SHOCK!", and the move reveals the alert: Pikachu's Thunder Shock, Charmander's Flamethrower, Squirtle's Water Gun, Bulbasaur's Razor Leaf or Eevee's Roar. The alert message then types into the battle box, and when the alert ends the Pokémon is recalled into its ball. You can override header and subtitle, and pick the Pokémon per event with pokemon.

Basic Example

{
    "pokemon": {
        "TwitchFollow": {
            "header": "New Trainer!",
            "subtitle": "A wild %username% appeared!",
            "pokemon": "pikachu"
        },
        "TwitchRaid": {
            "header": "Raid!",
            "subtitle": "%username% sent out %viewers% Pokémon!",
            "pokemon": "eevee"
        },
        "TwitchGiftedSub": {
            "header": "Gift Sub!",
            "subtitle": "%username% gave %recipient% a Rare Candy!",
            "pokemon": "bulbasaur"
        }
    }
}

Pokémon Theme Fields

Field	Description	Example
header	Big header revealed by the move	"header": "New Trainer!"
subtitle	Message typed into the battle box. The username is shown in red.	"subtitle": "A wild %username% appeared!"
pokemon	Which Pokémon comes out for this event: pikachu, charmander, squirtle, bulbasaur, eevee or random	"pokemon": "charmander"
headerColor	Header fill colour (Pokémon yellow by default)	"headerColor": "#ffcb05"

• You only need to include the events you want to customize
• Missing events will use the default text
• Make sure your JSON is valid - use a JSON validator to check
• On Pastebin, make sure to use the raw URL (click "raw" button or add /raw/ to the URL)
• Variables are case-insensitive (%Username% works the same as %username%)