Echolume + Twitch

Make your Twitch stream interactive — let viewers control Echolume's visuals with chat commands while the audio drives the animations.

What is the Twitch integration?

Echolume can listen to your Twitch chat in real time. When viewers type commands like !theme or !glitch, the visuals change live on stream. Combined with audio-reactive effects, it creates a unique, interactive experience.

Setup

  1. Open Echolume and go to Setup.
  2. Enable Twitch Chat and enter your channel name (e.g. your_twitch_username).
  3. Echolume connects automatically — no login or OAuth required.
  4. Choose your audio source (e.g. BlackHole 2ch from OBS) and press Ready.

Chat commands

Viewers can type the following commands in Twitch chat:

!theme [name]
Switch visual theme. Example: !theme aurora
!scene [name]
Switch scene type. Example: !scene radial
!shape [name]
Switch shape style. Example: !shape dots
!randomize
Random combination of theme, scene, and shape.
!glitch
Trigger a short glitch effect.
!abstract [0–100]
Adjust the abstraction level. Example: !abstract 75

Stream setup with OBS

To include Echolume in your Twitch stream:

  1. Follow the OBS guide to route audio from OBS to Echolume via BlackHole.
  2. In OBS, add Echolume's window as a Window Capture source.
  3. Position it as a background or overlay in your scene.
  4. Start your stream — viewers can now control visuals via chat.

Tips

  • Cooldown: Echolume ignores repeated commands within a short interval, so chat spam doesn't disrupt the visuals.
  • External display: Run Echolume fullscreen on an external display and use Display Capture in OBS for the best quality.
  • Combine with audio: Twitch commands and audio-reactive effects work together — viewers change the theme while the music drives the motion.

Troubleshooting

Chat commands don't work.
Check that Twitch Chat is enabled in Setup and the channel name is correct (without #). Make sure Echolume has internet access.
The connection keeps dropping.
Echolume reconnects automatically. If the problem persists, check your internet connection.
Viewers can't see the effect.
Make sure Echolume's window is added as a source in OBS and is visible in your scene.