What It Is

Song Overlays Pro is a native macOS application that:

  • Detects songs playing on your Mac using Apple’s ShazamKit (local processing).
  • Outputs song info to browser overlays (OBS/Streamlabs), Discord webhooks, and OSC (Resolume, TouchOSC, QLab).
  • Offers optional Song Requests so audiences can request songs via QR code or link.

Who It’s For

  • Streamers (Twitch/YouTube) who want a reliable “now playing” overlay.
  • DJs and event hosts who want QR-based song requests and real-time management.
  • VJs/creatives who need song metadata via OSC in Resolume/TouchOSC/QLab.

How It Works

  1. Install on macOS 13.0+ and grant microphone permission for detection.
  2. Start the in-app web server and paste the provided URL into an OBS Browser Source.
  3. Play music on your Mac; detected songs update overlays, can post to Discord, and send via OSC.

Key Outputs

  • Browser overlays: Now playing, request queue, QR code, and incoming-request notifications.
  • Discord: Webhook posts (optionally with album art and buffering).
  • OSC: Title, artist, artwork path/base64 to supported apps.

Song Requests (Premium)

  • Audience scans a QR code or opens a link; submits requests in a mobile browser.
  • Requests appear instantly; status updates include Queued/Considering/Maybe Later/Not Tonight/Played.
  • When you play a requested song, Shazam auto-detection can mark it as Played.

Companion iOS App

Song Requests Pro (iOS 16+) lets you manage events, requests, profile, and view DJ statistics. It does not perform Shazam detection or generate overlays; those run on macOS.

Privacy

  • Core features (detection, overlays, Discord, OSC) run locally; no account required.
  • Song Requests uses a cloud backend for real-time sync; exports auto-delete after 30 days.

Glossary

  • Browser Source: An OBS/Streamlabs input that renders a web page as an overlay.
  • OSC: Open Sound Control; protocol to send song metadata to creative software.
  • Discord Webhook: URL used to post structured messages to a Discord channel.
  • ShazamKit: Apple framework used for local song identification.
  • QR Song Requests: Mobile web flow for attendees to request songs at events.

Learn more on the Features and Tutorials pages.