whatisgithub

What is apple-music-obs-overlay?

m-shintaro/apple-music-obs-overlay — explained in plain English

Analysis updated 2026-05-18

46PythonAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A tool that shows what song is playing in Apple Music as a live, transparent overlay inside OBS Studio for streaming and recording.

Mindmap

mindmap
  root((music overlay))
    What it does
      Live track overlay
      Transparent card
      Progress bar
    Tech stack
      Python
      HTML
      JavaScript
    Use cases
      Twitch overlays
      Screen recordings
      Portable Windows app
    Audience
      Streamers
      Content creators

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Show your currently playing Apple Music track, artist, and album art on a Twitch or YouTube stream.

USE CASE 2

Add a music progress bar overlay to screen recordings made in OBS.

USE CASE 3

Run a portable executable on Windows without installing Python to get the overlay working quickly.

What is it built with?

PythonHTMLJavaScript

How does it compare?

m-shintaro/apple-music-obs-overlaybetta-tech/harness-sddemmimal/control-layer
Stars464646
LanguagePythonPythonPython
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Windows users can run a portable executable with no install, macOS needs a local Python environment.

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

So what is it?

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.

Copy-paste prompts

Prompt 1
Show me how to add this Python music overlay as a Browser Source in OBS Studio.
Prompt 2
Explain how this tool reads currently playing track data from Music.app on macOS versus Windows.
Prompt 3
Help me change the port and polling speed using this tool's command-line options.
Prompt 4
Walk me through building a portable Windows executable from this project's source code.

Frequently asked questions

What is apple-music-obs-overlay?

A tool that shows what song is playing in Apple Music as a live, transparent overlay inside OBS Studio for streaming and recording.

What language is apple-music-obs-overlay written in?

Mainly Python. The stack also includes Python, HTML, JavaScript.

What license does apple-music-obs-overlay use?

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is apple-music-obs-overlay to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is apple-music-obs-overlay for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.