m-shintaro/apple-music-obs-overlay — explained in plain English
Analysis updated 2026-05-18
Show your currently playing Apple Music track, artist, and album art on a Twitch or YouTube stream.
Add a music progress bar overlay to screen recordings made in OBS.
Run a portable executable on Windows without installing Python to get the overlay working quickly.
| m-shintaro/apple-music-obs-overlay | betta-tech/harness-sdd | emmimal/control-layer | |
|---|---|---|---|
| Stars | 46 | 46 | 46 |
| Language | Python | Python | Python |
| Setup difficulty | easy | easy | easy |
| Complexity | 2/5 | 2/5 | 2/5 |
| Audience | general | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Windows users can run a portable executable with no install, macOS needs a local Python environment.
This project adds a live music overlay to OBS Studio, the software that streamers and video creators use to compose their screen. When you are playing a song in Apple Music on macOS or Windows, this tool shows the track title, artist, album art, and a real-time progress bar on top of your stream or recording. The overlay is fully transparent, so only the music card itself is visible against whatever else is on screen. The way it works is simple. A small Python program runs in the background and polls your music player every quarter-second for the current track details. It writes that information to a local file, and a bundled HTML page reads that file and renders the card. In OBS, you add a Browser Source and point it at a local web address that the Python program hosts. OBS then displays the card just like it would display any web content. On macOS the tool reads track and artwork data directly from Music.app using built-in system commands, so no extra software is needed. On Windows it reads from the operating system's media session interface, which any media player that registers with it can provide. If album art is not available from the player directly, the tool falls back to fetching artwork from the iTunes Search API. Windows users who do not want to install Python can download a portable executable from the releases page. Double-clicking it starts the server with no setup required. For everyone else, setup is a clone, an optional dependency install on Windows, and a single command to start the server. The overlay supports 1080p and 4K scaling presets, a demo mode that shows the card layout without any music playing, and command-line options to change the port, polling speed, and artwork behavior. The project is released under the MIT license.
A tool that shows what song is playing in Apple Music as a live, transparent overlay inside OBS Studio for streaming and recording.
Mainly Python. The stack also includes Python, HTML, JavaScript.
MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly general.
This repo across BitVibe Labs
Verify against the repo before relying on details.