Self Help • Documentation

StreamChaosControls Help Center

Everything you need to set up StreamChaosControls, connect Twitch, configure controls, manage overlays, counters, chat commands, redeems, moderators, and troubleshoot common problems. Desktop builds from v0.03.03 add improved follow/raid alerts, optional raid clips, and dedicated viewer page URLs—see Downloads for release notes and the latest Windows installer.

Getting Started Viewer: Start here Downloads Viewer page links Viewer features Viewer coins & loot boxes Follow, raid & OBS Controls Overlays Moderators

Documentation

StreamChaosControls has two main parts: the web dashboard and the desktop app. The dashboard is where you manage your profiles, overlays, counters, commands, redeems, and moderators. The desktop app is what actually executes controls and plays approved runtime events on your PC.

1. Sign In

Use Twitch to sign in and reach your Streamer Dashboard.

2. Run Desktop

Keep the desktop app open while streaming so controls and overlays can run.

3. Build Your Setup

Create or copy profiles, upload overlays, configure stream alerts in Setup > Alerts, create counters, and test before going live.

Quick Start Checklist
  1. Sign in with Twitch and open the Streamer Dashboard
  2. Run the desktop app
  3. In Viewer Shop, disable any single screen effect or disable the entire module
  4. In Setup > Global Settings set your preferences
  5. In Setup > Controls, set your active game from System profiles or create/duplicate a control profile, or disable controls altogether
  6. In Setup > Overlays, generate a browser source, copy the browser source link, then add a Browser Source in OBS (see OBS and Browser Sources)
  7. In Setup > Alerts, generate a browser source, copy the browser source link, then add a Browser Source in OBS (see OBS and Browser Sources)
  8. Test one control, one overlay, and one counter before going live. This is best achieved by accessing your viewer page from your phone.

Viewers use the streamer's dedicated viewer page to interact with controls, overlays, shop actions, and stream features enabled by that streamer.

  1. Open the streamer's viewer link (usually /viewer/u/<streamer_login>).
  2. Sign in with Twitch.
  3. Use available controls and actions shown on that page.
  4. If a feature is missing, the streamer may have it disabled or restricted by tier/module settings.
  5. Visit viewer profile to review your viewer details and available badges.

Viewer features depend on what the streamer has enabled. Some channels expose shop actions, wheel/spinner entries, or chat-command triggered interactions.

  • !clip can be triggered by viewers when the streamer has granted the required Twitch scope.
  • !enter [spinner name] can enter a viewer into a selected entry wheel only when that wheel and entry path are enabled by the streamer.
  • Viewer Shop effects may be disabled by the streamer globally or per effect.
  • Cooldowns, limits, and module settings can prevent repeated triggers even when commands are valid.

Viewers can purchase coins and loot boxes from supported channels, but this is not mandatory. You can still watch and participate in free interactions where the streamer allows them.

  1. Open the streamer's viewer page and sign in with Twitch.
  2. Open the shop/coins area if that streamer has enabled it.
  3. Select a coin pack or loot box option and complete checkout.
  4. Use your coins for enabled viewer actions, or open loot boxes to claim rewards.

Examples of loot box rewards

Loot box contents vary by streamer setup, but can include bonus coins, temporary profile cosmetics, badges, effect tokens, and channel-configured interactive perks.

I clicked an action but nothing happened

The streamer may have the module disabled, the action on cooldown, or limits reached. Sign in again or refresh the page and try once, then ask the streamer to verify module and cooldown settings.

I cannot use spinner commands

Make sure you used the correct spinner name. If !enter still does nothing, that spinner may be disabled or not configured on the streamer's dashboard.

I cannot sign in on the viewer page

Try signing out/in with Twitch again and refresh the page. If sign-in still fails, ask the streamer to check the platform status and reconnect Twitch on their side if required. Additionally you can reach out on Discord and one of the members of staff will be happy to assist you.

The desktop app is required for gameplay controls and desktop-managed overlay behavior. If the app is not open, keyboard and mouse actions will not run locally.

  1. Download the latest Windows installer from Downloads (authenticated streamers; file name is typically StreamChaosDesktopSetup.exe)
  2. Run the setup program and complete the install wizard
  3. Launch Stream Chaos Desktop from the Start menu
  4. Enter your Desktop Auth Key
  5. Click Connect Runtime
  6. Sign in with Twitch
  7. Leave it running while you stream

Update Checks

On launch, the StreamChaosControls desktop app polls the server to check for updates and prompts you if one is available. It will download and install the new version; you just need to relaunch the application. You can manually trigger a check from Help > Check for Updates....

StreamChaosControls uses Twitch authentication for streamers and approved moderators. Twitch permissions allow SCC to interact with chat, clips, redeems, and other supported systems.

  • Streamer sign-in: Use Twitch OAuth from the sign in page
  • Moderator sign-in: Approved moderators sign in from the moderator page using Twitch
  • Re-authentication: If a new feature needs a new Twitch permission, you may need to reconnect Twitch once

Clip Permission

If !clip is not working, reconnect Twitch so SCC can obtain the clips:edit scope.

Stream event alerts and desktop-driven media overlays use different OBS setups: follow, raid, shoutout, and other stream alerts come from a Browser Source you generate under Setup > Alerts; image, video, and webm overlays are shown in the StreamChaosDesktop window and are usually captured with Window Capture (below).

StreamChaosControls overlays can be captured in OBS using a dedicated overlay window. If you are using the desktop overlay window, use the setup below.

Recommended OBS Setup
  • Source: Window Capture
  • Window: StreamChaosDesktop.exe: Overlay
  • Capture Method: Windows 10 (1903 and up)
  • Window Match Priority: Window title must match
  • Capture Audio (Beta): Enabled if you want OBS to capture overlay audio from that window
  • Client Area: Enabled

After adding the source, position it in your scene where you want overlays to appear. Test one image overlay and one video or webm overlay before going live.

Important Notes

If the overlay does not appear, confirm the desktop app is running and the overlay window is open. If audio is missing, verify that Capture Audio (Beta) is enabled in OBS for that source.

Stream alerts in OBS (follow, raid, shoutout, and more)

Follow, raid, shoutout, and other stream alerts are configured from Setup > Alerts in the Streamer Dashboard. Generate a browser source there, copy the link, then add it as a Browser Source in OBS.

To set up follow, raid, shoutout, and other stream alerts in OBS:

  1. Go to the Streamer Dashboard.
  2. Navigate to Setup > Alerts.
  3. Generate a browser source.
  4. Copy the generated browser source link (SCC provides the full URL; do not build or guess an alerts URL by hand).
  5. In OBS, add a new Browser Source.
  6. Paste the copied SCC browser source link into the Browser Source URL field.
  7. Set the Browser Source width and height to the dimensions recommended on the Alerts page.
  8. Save or apply the OBS source.

After StreamChaosControls deploys an update, refresh the Browser Source in OBS (or open its properties and click OK) so the alert page loads the latest version—improved clip embeds, parent= handling, and autoplay or audio flags may depend on that refresh.

Each streamer has a dedicated viewer page on this site. Share it so viewers always know which channel they are controlling.

  • URL pattern: /viewer/u/<your_twitch_login> on your StreamChaosControls host (for example https://app.streamchaoscontrols.com/viewer/u/yourname).
  • Your full link appears on the streamer dashboard under Setup → Viewer page link (copy/paste it for panels, Discord, or chat).
  • After you sign in with Twitch, your Twitch login is stored for that link. If the path still shows a long internal id instead of your login, sign out and complete Twitch sign-in again.
  • The generic /viewer page lets viewers search for a streamer; shared links should use the dedicated URL so there is no ambiguity.

Recent builds improve how follow and raid alerts behave together with optional raid clips and Twitch’s clip player.

For OBS, follow, raid, shoutout, and other stream event alerts are set up from Setup > Alerts in the Streamer Dashboard: generate a browser source, copy the browser source link, then add a Browser Source in OBS. Full steps are in OBS and Browser Sources under Stream alerts in OBS.

  • Queued alerts: Multiple follows or raids in quick succession are queued in the desktop app so one alert does not overwrite another mid-display.
  • Raid clips: After the raid banner, a random clip from the raider’s channel may play inside the same follow/raid alert window (not the separate media overlay window). If the raider has no clips, the app skips the clip phase without errors.
  • Twitch clip embeds: The app uses improved URL parameters and playback handling so clip audio is more reliable. Content-classification (“Start Watching”) prompts on Twitch clip embeds are handled automatically where the platform allows.
  • Stream alerts in OBS (Browser Source from Setup > Alerts): The alert page you add as a Browser Source uses correct parent= handling in the raid-clip iframe when Twitch’s API already includes parents, plus embed flags for autoplay and audio. An overly strict iframe sandbox that could block Twitch’s player in OBS has been removed. After SCC updates, refresh the Browser Source in OBS that uses the link you copied from Setup > Alerts.
  • Backend: Random raid clips are fetched via Twitch Helix using your linked broadcaster token; failures or empty clip lists are handled gracefully.

No audio from the app or clips?

On Windows, open Volume mixer (taskbar speaker → Volume mixer) and check Stream Chaos / StreamChaosDesktop / WebView2 (or similar) for mute and level. Confirm Settings → System → Sound is using the playback device you actually listen on. See also the Troubleshooting section below.

A profile is a collection of controls. A control is a specific viewer-triggered action, such as moving left, jumping, crouching, or interacting.

  • System Profiles: Read only built-in profiles that do not count against custom profile limits
  • My Profiles: Your custom editable profiles
  • Duplicate: Copy a system profile into your own profile list and modify it safely
Create a Custom Control
  1. Open your profile under My Profiles
  2. Add a control name and a chat command
  3. Add one or more actions, such as key or mouse actions
  4. Set duration and cooldown as needed
  5. Save and test in the desktop app

WASD Rules

SCC supports directional stacking like W + D for strafing. Opposing directions are blocked. System profile WASD controls also enforce a standard press duration to keep movement behavior fair and predictable.

Overlays are visual or audio media items that can be triggered by chat commands, counters, redeems, or other runtime actions. You can use images, gifs, videos, and transparent webm files.

  1. Go to the overlays section
  2. Create a new overlay or use a system overlay if available
  3. Set the display name and media URL
  4. Enable or disable it as needed
  5. Test it live in OBS with the desktop overlay Window Capture source active (see OBS and Browser Sources)

Counters can track stream events and optionally trigger linked actions. A counter can be global, per user, per stream, or all time depending on the scope you choose.

  • Name: The counter label viewers or streamers recognize
  • Value: Starting or current numeric value
  • Scope: How the total is tracked
  • Linked Action: The kind of thing the counter will trigger, such as an overlay or control
  • Linked Target: The specific overlay or control selected from a safe dropdown

Important

SCC now supports showing a Linked Target dropdown instead of making you edit raw UUIDs. If you link a counter to an overlay, you should see overlay names instead of internal IDs.

Chat commands can be used to trigger controls, post messages, or activate supported runtime behavior. SCC also includes important built-in behavior for commands like shoutouts and clips.

  • !so only triggers when the exact command is used
  • Plain text starting with so no longer triggers shoutouts accidentally
  • !clip can now be used by any viewer in chat
  • !spin [spinner name] is a streamer-side/runtime command and is not viewer-triggered
  • !enter [spinner name] can be used for viewer entry when the streamer has enabled that entry wheel path

Streamers can build redeems that trigger controls, overlays, or related actions. SCC supports both channel point redeems and bits-driven interactions where enabled by tier.

  • Redeems can be enabled or disabled independently
  • Bits and channel point redeems can bypass the standard global control cooldown
  • Moderators with the correct permission can create bit redeems for the streamer

Approved Moderators let you delegate specific tasks while staying inside your tier limits. Moderators authenticate with Twitch, and streamers decide exactly what each moderator can do.

Add Only

Allow a moderator to add supported items without giving delete access.

Add/Delete

Allow a moderator to create and remove supported items.

Extra Access

Enable or disable overlays, create bit redeems, or change the active control profile.

  1. Open the Approved Moderators area in the Streamer Dashboard
  2. Enter the moderator's Twitch login
  3. Select the access level and extra permissions you want to allow
  4. Save the moderator entry
  5. The moderator signs in through the moderator page using Twitch

Limits Still Apply

Moderators are still bound by the streamer's plan limits. They do not get extra profiles, overlays, chat commands, or redeems beyond the streamer's tier.

SCC now protects against repeated automatic shoutouts by limiting auto shoutouts to once per stream per person. This reduces Twitch cooldown issues and duplicate shoutout spam.

Shoutout and other on-stream event alerts in OBS use the same path as other stream alerts: in the Streamer Dashboard open Setup > Alerts, generate a browser source, copy the browser source link, and add a Browser Source in OBS. See OBS and Browser Sources.

  • Auto shoutouts: Limited to one per stream per person
  • Twitch limits still apply: Twitch can still reject requests if platform cooldown conditions are hit outside SCC
  • Clips: Any viewer can use !clip if the streamer has granted the required Twitch scope

The StreamChaosControls desktop application executes local gameplay controls, overlay runtime features, and other actions that must run directly on the streamer’s computer. The desktop app should remain open while streaming if viewer controls or desktop overlays are enabled.

Operating System

Windows 10 (1903 or newer) or Windows 11.

Minimum RAM

4 GB RAM.

Recommended RAM

8 GB RAM or more for smoother streaming alongside OBS and games.

  • Minimum CPU: Dual core processor (Intel i3 / Ryzen 3 equivalent)
  • Recommended CPU: Quad core processor (Intel i5 / Ryzen 5 or better)
  • Graphics: Integrated GPU with DirectX 11 support minimum
  • Recommended GPU: Dedicated GPU (NVIDIA GTX 900 series or newer, AMD RX series or newer)
  • Storage: Minimum 200 MB free space
  • Recommended Storage: 1 GB free space for updates and overlay media caching

Network Requirement

A stable internet connection is required so the desktop app can communicate with the StreamChaosControls backend. Bandwidth usage is minimal because actions are lightweight API events.

Recommended Streaming Setup

For the best experience running StreamChaosControls during a live stream, use a system with 8 GB RAM or more, a quad core CPU, a dedicated GPU, OBS Studio installed, and the SCC desktop app running throughout the stream.

SCC enforces streamer plan limits on the backend. If a module is disabled, every item inside that module is disabled too.

  • System profiles do not count against custom profile limits
  • Custom profiles do count
  • Controls and overlays can have global cooldown behavior
  • Repeated rapid triggers can be temporarily blocked by spam protection
  • Modules can be enabled or disabled for Controls, Overlays, Chat Commands, and Bit Redeems

Overlay is not showing

For media overlays, use Window Capture on the StreamChaosDesktop overlay window and keep the desktop app running; confirm the overlay is enabled and the media URL is valid (see OBS and Browser Sources). For stream event alerts (follow, raid, shoutout, and similar), add a Browser Source in OBS with the browser source link from Setup > Alerts—not a manually typed URL.

Control is not working

Confirm the desktop app is connected, the control is enabled, the profile is active, and the action is not blocked by cooldown or spam protection.

Clip command is not working

Reconnect Twitch so the streamer account can grant the clips:edit permission. Then test !clip again.

Linked Target dropdown is blank

The saved linked target may no longer exist, or the linked action type may not match a current asset. Choose a valid target from the dropdown and save again.

Moderator cannot do something they should have access to

Check the moderator's assigned permissions, confirm they signed in with the correct Twitch account, and verify the streamer has not hit their plan limits.

No sound from raid clips or alert windows

Use Windows Volume mixer and system sound output settings (see Follow & raid alerts, clips, and audio above). In OBS, confirm capture settings if you route alert audio through desktop capture.

Sign-in fails with oauth_error=callback_failed

Usually this means the Twitch callback hit a server error—often a database migration that has not been applied on your environment yet, or a transient Twitch/token issue. Self-hosted operators should apply all pending SQL migrations, redeploy, and try again; check server logs for the underlying error. After migrations are current, sign-in should succeed.

Is StreamChaosControls already in beta?

Yes. Beta testing began on March 6th, 2026.

When is the official public release?

The current official public release is April 25th, 2026.

When does early access end?

June 24th, 2026 23:59:59 UTC

Can I try it for free?

Yes there is a Free tier that has limited access to customization, it is enough to test the application and decide if you like it. There is never any need to upgrade unless you choose to do so.

Do I need the desktop app?

Yes for local gameplay control execution, overlays, and alerts you need the desktop application to be installed, running and connected.

Staff quick links for support replies

Share direct section links when a user asks a question already covered in the Help Center: Getting Started, Desktop App Setup, OBS and Browser Sources, Chat Commands, FAQ.

You can also use ?help= shortcuts for staff messages: ?help=getting-started, ?help=desktop-app, ?help=obs, ?help=chat-commands, ?help=faq.