Twitch Raid Alert Auto Shoutout Widget

TWITCH RAID ALERT & AUTO SHOUTOUT WIDGET — ANIMATED SHOUTOUT CARD WITH REAL AVATAR, GAME, TITLE & FOLLOWERS (STREAMELEMENTS & OBS)

Turn every raid into a gorgeous, automatic shoutout. When you get raided — or a mod types !so (channel) — a beautiful animated card pops up featuring the other streamer: their real Twitch avatar, name, the game they were last playing, their stream title, their follower count, and a "go show them love" call-to-action, plus the raid context ("Raider raided with 42!"). It's a real shoutout with the raider's actual channel info, not just a "go follow @name" line — and it makes the constant chore of shoutouts effortless and on-brand.

It runs standalone with no token and no monthly fees — raid detection and the raider's avatar, last game, title, and follower count all pull token-free.

━━━━━━━━━━━━━━━━━━━━
✦ HOW IT WORKS
━━━━━━━━━━━━━━━━━━━━
- AUTO ON RAID — detects the incoming raid (raider + viewer count) and fires the card, with a minimum-raider threshold so tiny/ghost raids don't spam you
- MANUAL !so (channel) — shout out any channel on command (renameable, mod/broadcaster only)
- PANEL / HOTKEY — trigger or test a shoutout from the control panel
- Multiple raids close together? They queue cleanly, one beautiful card at a time

━━━━━━━━━━━━━━━━━━━━
✦ WHAT THE CARD SHOWS (ALL TOGGLEABLE)
━━━━━━━━━━━━━━━━━━━━
- The channel's REAL Twitch avatar as a glowing hero portrait
- Display name, last game played (with optional box art), and stream title
- Follower count in crisp tabular figures
- A call-to-action pill with their twitch.tv link
- A raid-context banner ("Raider raided with 42!") when raid-triggered
- Smart phrasing — "live now playing X" vs "was last playing X"
- Optional live-preview thumbnail background (when they're live)

━━━━━━━━━━━━━━━━━━━━
✦ THE RAID MOMENT (CELEBRATORY)
━━━━━━━━━━━━━━━━━━━━
- A springy intro with a sparkle burst and glow flare; the avatar pops, the info slides in
- Big-raid escalation — a larger entrance and confetti for high-viewer raids
- A graceful outro after a configurable hold
- Three layouts: avatar-left + info-right, preview-background, or compact

━━━━━━━━━━━━━━━━━━━━
✦ THE LOOK — ROSE QUARTZ
━━━━━━━━━━━━━━━━━━━━
- A darker plum housing so the avatar and text pop, with a slow living aurora gradient underlay
- A rose-gold filigree frame, corner charms, floating hearts and sparkles, and a holographic sheen sweep
- An avatar hero with a rotating glow ring, gentle breathing, and a choice of frame shapes (heart, circle, squircle, hexagon)
- Premium rounded typography — matches the rest of the ViperVex shop

━━━━━━━━━━━━━━━━━━━━
✦ THEMES (+ FULL CUSTOM)
━━━━━━━━━━━━━━━━━━━━
- Rose Quartz — the girly-premium hero
- Aurora Glass · Luxe Gold · Neon Arcade · Cyber HUD · Cozy Hearth · Comic Kawaii · Minimal Pro
- Full per-element color + multi-stop gradient control on every element

━━━━━━━━━━━━━━━━━━━━
✦ RUNS STANDALONE — HONESTLY
━━━━━━━━━━━━━━━━━━━━
- The on-screen card runs fully standalone with no StreamElements: raid detection (via Twitch's raid event over anonymous chat) plus the raider's avatar, last game, title, and follower count all pull token-free
- Honest notes: embedding a clip needs StreamElements or a Helix bot, and auto-posting a shoutout message into your chat needs a bot/token (anonymous chat can read but not send). This widget's job is the gorgeous on-screen card — and it nails that with no token.

━━━━━━━━━━━━━━━━━━━━
✦ DEEP CUSTOMIZATION
━━━━━━━━━━━━━━━━━━━━
- Auto-on-raid on/off + minimum raider threshold; !so command name + permissions
- Toggle any card element; choose layout, avatar frame shape, and CTA text
- Dwell time, queue behavior, intro/outro style, big-raid escalation threshold
- Full color + gradient control, decoration toggles, optional raid sting sound (mutable), performance mode, and reduced-motion support
- 9 positions, scale, and dimensions

━━━━━━━━━━━━━━━━━━━━
✦ WHAT'S INCLUDED
━━━━━━━━━━━━━━━━━━━━
- StreamElements custom widget files (ready to import)
- OBS standalone single-file version (anonymous chat + DecAPI + control panel)
- Built-in TEST mode to preview shoutouts (including a big-raid escalation)
- README.md — setup for both platforms, the honest capability matrix (card runs standalone; clips need SE/Helix; chat-posting needs a bot), triggers and thresholds, card content and layouts, themes, and full color & gradient options, written for non-technical streamers

━━━━━━━━━━━━━━━━━━━━
✦ COMPATIBILITY
━━━━━━━━━━━━━━━━━━━━
- StreamElements, OBS Studio, and any software with a Browser Source
- Built for Twitch (raid detection + DecAPI channel info, token-free)
- Desktop setup (runs as a browser source on your computer, not on mobile)

━━━━━━━━━━━━━━━━━━━━
✦ INSTANT DIGITAL DOWNLOAD
━━━━━━━━━━━━━━━━━━━━
This is a digital product. Files are available to download immediately after purchase. Because of the instant-download nature, this item is non-refundable — but if you run into any trouble, message me and I'll gladly help you get set up.

━━━━━━━━━━━━━━━━━━━━
✦ LICENSE & TERMS OF USE
━━━━━━━━━━━━━━━━━━━━
By purchasing, you receive a single-user license to use this widget on your own stream(s):
- YOU MAY use it on your personal and monetized streams (Twitch, YouTube, Kick, etc.)
- YOU MAY customize the colors and settings for your own channel
- YOU MAY NOT resell, redistribute, share, sublicense, or give away the files
- YOU MAY NOT claim the design as your own or include it in another product for sale
All files remain the intellectual property of ViperVex. This license is non-transferable.

━━━━━━━━━━━━━━━━━━━━
✦ A NOTE ON CREATION
━━━━━━━━━━━━━━━━━━━━
This widget was designed and built with the help of AI tools, then refined and tested for quality, smooth animation, and reliable raid detection.

━━━━━━━━━━━━━━━━━━━━
✦ ABOUT THE BRAND
━━━━━━━━━━━━━━━━━━━━
Created by ViperVex — premium, animated stream widgets and overlays.
🌐 Website: www.vipervex.com
🛒 Etsy Shop: etsy.com/shop/ViperVex

Thank you for supporting ViperVex! ⚡