m-shintaro

m-shintaro / apple-music-obs-overlay

Public

A now-playing overlay for OBS on macOS & Windows — Apple Music, Spotify, YouTube, and more — with artwork, track info, and a progress bar.

apple-music obs obs-studio overlay streaming
43
0
89% credibility
Found May 30, 2026 at 43 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

This project creates a transparent overlay that shows what's currently playing in Apple Music on your OBS stream. It displays the song title, artist name, album artwork, and a live progress bar so your viewers can see your music in real time. The tool runs in the background on your computer and sends the information to OBS through a simple web address.

How It Works

1
🎵 You want to show your music on stream

You love streaming and want your viewers to see what song is playing in Apple Music without any extra work.

2
📎 You download the overlay tool

You grab the portable version for Windows or run a simple command on Mac, and the tool sets itself up automatically.

3
🔌 You launch the app and it finds your music

With one click, the app reads what's playing in Apple Music and starts tracking the song, artist, album art, and progress bar.

4
You pick your streaming setup
🎮
OBS Browser Source

You paste a simple web address into OBS and the overlay appears directly on your stream.

〽️
OBS Text Source

You use the plain text version to show song info as scrolling text on your stream.

5
🎥 Your stream now shows live music

Viewers see the album artwork, song title, artist name, and a real-time progress bar right on your stream.

🎉 Your stream feels more alive

Your audience connects with your music taste, and your stream has a polished, professional feel without any extra effort.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 43 to 43 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is apple-music-obs-overlay?

A lightweight OBS overlay that displays whatever track you're playing—album art, artist, title, and a live progress bar—inside a transparent browser source. The Python backend polls your system for playback data and serves an HTML overlay at localhost:8765, which you drop into OBS as a Browser Source. On Windows, you can grab a portable executable and run it without Python installed. On macOS, it reads directly from Music.app using AppleScript.

Why is it gaining traction?

The setup is refreshingly simple: one CLI command to start, one URL to paste into OBS, done. It handles the small details that matter for streams—progress bar updates at quarter-second intervals, automatic iTunes artwork fallback when direct extraction fails, and 4K scaling for high-resolution layouts. The demo mode lets you preview the overlay without touching your actual playback, which is useful when you're tweaking positioning before going live.

Who should use this?

Streamers who want a "now playing" card in their OBS scenes without installing bloated streaming tools or paying for widgets. It's particularly useful for music-focused streams, study sessions, or anyone who wants their audience to see what's playing without cluttering the screen. macOS Music users and Windows Apple Music users will get the smoothest experience; others may find the provider support more limited than the description suggests.

Verdict

This solves a real problem cleanly, but with only 43 stars and a 0.9% credibility score, the project is early-stage with a small user base. The code quality looks solid and the documentation is thorough for what it covers, but test coverage and community backing are minimal. Worth trying if you fit the use case—just don't bet a production stream on it without a backup plan.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.