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
- Install on macOS 13.0+ and grant microphone permission for detection.
- Start the in-app web server and paste the provided URL into an OBS Browser Source.
- 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.