v0.2 — Windows support

OBS Apple Music Progress Bar v0.2

Windows に対応しました 🎉 これまでの macOS に加えて、Windows 10/11 でも
再生中の曲を OBS オーバーレイとして表示できます。

ダウンロード

Windows（おすすめ・Python 不要）
下の Assets から OBSAppleMusicProgressBar-0.2-windows-x64.zip をダウンロードしてください。

macOS / ソースから使う場合

git clone https://github.com/m-shintaro/apple-music-obs-overlay.git
cd apple-music-obs-overlay
python3 nowplaying.py

かんたんセットアップ

1. 起動する
   • Windows: ZIP を展開して OBSAppleMusicProgressBar.exe をダブルクリック
   • macOS: python3 nowplaying.py を実行
2. OBS で Browser Source を追加し、URL に次を指定:

   http://localhost:8765/overlay.html

3. 音楽を再生すると、曲名・アーティスト・ジャケット・再生バーが表示されます。

4K 配信は URL に ?profile=4k を付けてください。
推奨ソースサイズ: 1080p は 896 × 300 以上 / 4K は 1792 × 600 以上。

既知の注意点

• Windows で曲が出ない場合は、再生中のアプリがメディアセッションに対応しているか確認してください。
• うまく動かないときは --diagnose-artwork を付けて起動すると診断情報が出ます。

詳しい使い方は README を参照してください。

v0.1.0 – First public Apple Music OBS overlay

OBS Apple Music Progress Bar v0.1.0

First public release of a lightweight macOS Apple Music / Music.app now-playing overlay for OBS.

Highlights

• Shows the current Apple Music / Music.app track in OBS
• Displays title, artist, album artwork, elapsed time, total time, and live progress
• Transparent Browser Source overlay
• No third-party Python dependencies
• Uses macOS built-in osascript and sips
• Includes 1080p and 4K scaling presets
• Includes demo mode for previewing without playback

Quick Start

git clone https://github.com/m-shintaro/apple-music-obs-overlay.git
cd apple-music-obs-overlay
python3 nowplaying.py

Then add this URL as an OBS Browser Source:

http://localhost:8765/overlay.html

Privacy

Playback metadata is read locally from Music.app.
When direct artwork export fails, the fallback artwork lookup may send artist and title to the iTunes Search API. Use --no-network-artwork to disable this.

Known limitations

• macOS only
• Requires Music.app / Apple Music
• Not an official Apple or OBS project