streamtoolset
DocsChecking session…

Overlays

When a chatter types !lurk, their Twitch avatar slides in from a random screen edge, gives a little wave, and slides back out — a quick visual cue that someone's going on lurk.

What it's for

  • Acknowledging lurkers without breaking flow on stream.
  • A small recurring delight that uses each viewer's actual avatar.
  • Welcoming the regulars who tune in for background noise.

How to set it up

  1. Create a hosted source on the settings page and paste the browser source URL into OBS.
  2. Set the chat command (default !lurk) and who can run it.
  3. Tune the avatar size, animation duration, and wave angle to taste.
  4. Pick avatar shape + orientation. Circle crops to the standard Twitch profile circle; Natural keeps transparent PNGs as-is. Edge-relative rotates avatars entering from the side or top so they "come in feet first" from that edge.

FAQ

How does it work?
The overlay polls Twitch's Helix API for the chatter's avatar and caches it for an hour. When the lurk command is detected via tmi.js, the avatar slides in from a random edge.
Why is the channel field needed?
The overlay connects to Twitch chat via tmi.js to listen for the command — same pattern as Emote rain. Defaults to your own channel; change it if you want the overlay to listen on a different channel.