Real-time Song Detection

Show What You're Playing

Beautiful song overlays for your Twitch stream. Automatic detection. Zero configuration. Completely free.

Everything You Need

Built for streamers, by streamers. Simple, powerful, and completely free.

Auto Detection

Instantly recognize songs playing on your stream using Shazam technology.

Smooth Animations

Professional overlays with album art, artist info, and beautiful transitions.

Easy Setup

Copy a URL into OBS. No API keys, no configuration, no coding required.

100% Free

No subscriptions, no premium tiers, no hidden costs. Always free forever.

Maintained Project

Actively maintained by Glitch Studios with regular updates and improvements.

Reliable

Battle-tested infrastructure with 99.9% uptime guarantee.

Under the Hood

Three steps from stream to overlay, all automatic.

1

Audio Captured

A short clip is taken from your live stream's audio feed every few seconds via the Twitch API.

2

Fingerprinted

The clip is fingerprinted and cross-referenced against Shazam's catalog of tens of millions of tracks.

3

Shown Live

Song title, artist name, and album art are pushed to your OBS overlay instantly - no action needed from you.

Get Started in 2 Minutes

Follow these simple steps to add song detection to your stream.

1

Enter Your Channel Name

Select your platform and enter your channel name to generate the overlay URL:

https://overlay.glitchstudios.dev/YOUR_CHANNEL?style=cover-scroll&artwork=1&artist=1&status=1&bar=0&showfor=12&refresh=4&scale=1.15&width=280&textsize=18&align=bottom-right&x=20&y=20
  • platform: twitch (default) or kick
  • style: default, cover-scroll, or banner (overlay design preset)
  • artwork: 1 or 0 (show album art)
  • artist: 1 or 0 (show artist text)
  • status: 1 or 0 (show status row/icon)
  • bar: 1 or 0 (show animated status bar)
  • showfor: 0 to 120 (show overlay for X seconds after each new song detect; 0 = stay visible until detection/song ends)
  • refresh: 2 to 30 (API refresh interval in seconds)
  • scale: 0.6 to 2 (overlay scale)
  • width: 220 to 700 (widget width in px)
  • textsize: 10 to 40 (cover-scroll / banner text size in px)
  • align: top-left, top-center, bottom-left, bottom-center, bottom-right
  • x and y: 0 to 160 (screen padding in px)
2

Add Browser Source in OBS

Open OBS, add a new Browser Source, and enter the URL above.

  • Width: 1920px
  • Height: 1080px
  • Check "Shutdown source when not visible"
3

Start Your Stream

Play music and watch songs appear on your stream automatically!

Play With Overlay Options

Adjust settings and preview your overlay before adding it to OBS.

https://overlay.glitchstudios.dev/yourchannel

Live Preview

Preview uses dummy song data so you can style it without needing a live channel.

Use Commands to Share Songs

Trigger song detection from chat with bot commands.

Fossabot Custom Command

Use the command endpoint to fetch the current song as plain text. Perfect for !song commands in StreamElements, Nightbot, or any custom bot.

$(customapi https://twitch.glitchstudios.dev/api/song-text/yourchannel)

Change yourchannel to your own Twitch channel name.

Response examples:

  • Song Name - Artist Name (when song detected)
  • No song detected (when idle or no match)
  • Stream is offline (when stream offline)

Test Recognition

Verify song detection with a Twitch clip.

Frequently Asked

How accurate is song detection?

Detection is best-effort and works well for most popular tracks. Accuracy can be reduced by heavy stream compression, background noise, voice-over, alerts, very low audio volume, or obscure tracks such as regional releases, instrumentals, and remixes. Some songs may be detected late, incorrectly, or not at all.

Is this site finished / in beta?

The site is actively developed and still in beta - things may change and occasional rough edges are expected. Feedback is always welcome in our Discord.

How do I set it up?

Copy your overlay URL from the setup section, add it as a Browser Source in OBS, then set the source size to 1920x1080. If style changes do not show right away, refresh the browser source cache once.

Is it free?

Yes, it is free. This setup uses the free recognition path and does not require any paid API key.

Why is my overlay not showing anything?

Most often this is an offline stream, muted/non-music audio, or a very fresh/remixed track that is harder to fingerprint. Use the test clip tool first to validate recognition, then verify your channel URL and browser source cache.

How often does the overlay refresh?

You can control it with the refresh URL option (2 to 30 seconds). Lower values feel more real-time but create more API traffic; 4 to 8 seconds is a good production range.

Can I auto-hide the overlay after detection?

Yes. Use showfor in the URL. Example: showfor=12 keeps the card visible for 12 seconds after a new song is detected. Set showfor=0 to keep it visible until detection ends.

Can I customize the look and position?

Yes. You can adjust width, scale, alignment, offsets, artwork/artist/status visibility, and refresh behavior from the customiser, then copy the generated URL directly into your scene.

What streaming software is supported?

Anything with a browser source works well, including OBS and Streamlabs. Use Chromium-based browser source rendering and keep hardware acceleration enabled for best animation performance.