🎮 ControlPlay – Turn Viewers into Players

ControlPlay turns interactive streaming into real gameplay participation: viewers trigger in-game actions with Twitch Bits — live on your PC via genuine keyboard, mouse, or controller inputs.

With the ControlPlay Stream Deck Plugin, you control your full setup with a single tap.

⚙️ What the Plugin Does
Connects to your local ControlPlay Client and gives you instant access to 9 stream actions:

🎮 Games

• Game On/Off — Enable/disable entire game configs instantly (dynamic icon + colors).

• Game Action — Activate/pause specific actions so you decide what viewers can trigger (optional profile bind).

• Game Profile — Switch profiles with one tap (button highlights when active).

🎨 Overlays

• Overlay System — Toggle the entire overlay effect system on/off.

• Overlay Effect — Toggle individual effects (e.g., Earthquake, Flashbang, Smoke).

🔊 Sounds

• Sound System — Toggle the full sound system (when off, no sounds are sent to the Twitch Extension)

• Sound Effect — Toggle individual sounds like Airhorn or Sad Trombone.

⚙️ System

• Do Not Disturb — Enable DND so only safe actions remain available (perfect for competitive moments).

• Status Display — See current status at a glance (games, DND, overlay + sound). Press to refresh.

💡 Visual Feedback
Buttons show state in real time:

• Enabled — Full-color icon

• Disabled — Dimmed + red X

• Offline — Dimmed when client isn’t running
  Updates happen instantly via push events — no polling, no delay.

🧩 How It Works

1. Install the plugin

2. Run the ControlPlay Client

3. Auto-connects locally (no configuration)

4. Drag actions onto Stream Deck keys

Fully local & secure: WebSocket connection to your local client — no cloud, no external API.

“No alt-tabbing — one press and ControlPlay reacts instantly.”

🔗 Learn More
• 🌐 https://controlplay.app
• 📘 https://discord.controlplay.app/

[2.1.0] — 2026-02-25

This update focuses on one thing: reliability. The plugin now stays connected better, recovers faster from drops, and won’t “give up” after a while.

Fixed

• Critical: The plugin could stop reconnecting after ~10 minutes. This limit is now removed — it will keep trying until the ControlPlay Client is reachable again.

• Improved reconnect behavior with a two-phase system: quick retries first, then steady long-term retries (no permanent disconnects).

• Reconnect timing is now capped so retries don’t become excessively slow.

• Manual reconnect triggers (e.g., when the plugin appears or you press a key) now properly restart the reconnect cycle.

• Better cleanup of old connections to prevent “stuck” or stale WebSocket sessions.

Improved

• Added a connection health check (regular ping/pong). If the connection silently dies, the plugin detects it and reconnects within ~40 seconds.

• Prevented overlapping reconnect attempts (no double-connection spam).

• When disconnected, pressing a Stream Deck key now starts reconnecting immediately and shows “Reconnecting…” instead of only displaying an alert.

• Fixed a rare issue where repeated failed connections could cause warnings and instability over time.