Harmony Deck: Apple Music Stream Display

A customizable Apple Music now playing display for macOS.

Features

• Shows currently playing Apple Music track on your stream
• Five beautiful themes (Polar Bear Cafe, Twitch, Dark, Pink, Light)
• Auto-width or full-width display options
• Automatically hides when no music is playing
• Support for album artwork
• Clean animated transitions between songs
• Font changes with each theme for a complete visual experience
• Settings menu appears only on hover (invisible to viewers)
• Settings are saved between sessions

Requirements

• macOS (uses AppleScript to communicate with Apple Music)
• Python 3.6 or later
• OBS Studio or similar streaming software with browser source support

Installation

1. Clone this repository:

   git clone /~https://github.com/yourusername/harmony-deck.git
   cd harmony-deck
   

2. Make sure the Python script is executable:

   chmod +x music_server.py
   

3. Start the server:

   ./music_server.py
   

4. Add a Browser Source in OBS:

   • URL: http://localhost:8080/
   • Width: 550 (recommended minimum)
   • Height: 80-100
   • Check "Refresh browser when scene becomes active"

Usage

Once installed, the overlay will automatically display your currently playing Apple Music tracks.

Theme Selection

Hover over the overlay to reveal the settings menu at the bottom:

• Polar Bear Cafe (default): Soft green theme with rounded corners
• Twitch: Dark purple theme that matches Twitch aesthetics
• Dark: Sleek black theme with cyan accents
• Pink: Vibrant pink theme with friendly typography
• Light: Clean white theme with blue accents

Width Options

In the settings menu:

• A: Auto width (only as wide as needed for the text)
• F: Full width (expands to fill the entire browser source width)

Troubleshooting

No music information appears:

• Make sure Apple Music is running
• Check Terminal for error messages
• Try playing/pausing music to trigger an update

Permission errors:

• macOS may need permission to control Apple Music
• Go to System Preferences → Security & Privacy → Automation
• Ensure Terminal (or whatever app runs the script) has permission to control Apple Music

Auto-Start on Boot

To make the server start automatically when you boot your Mac:

1. Create an Automator application:

   • Open Automator
   • Create a new Application
   • Add a "Run Shell Script" action
   • Enter: cd /path/to/harmony-deck && ./music_server.py
   • Save as "Start Harmony Deck"

2. Add to Login Items:

   • System Preferences → Users & Groups → Login Items
   • Add the Automator application you created

Customization

Advanced users can modify the CSS in overlay.html to create custom themes or change the layout.

License

MIT License

Acknowledgements

• "Polar Bear Cafe" theme is inspired by the aesthetic of Polar Bear Cafe anime
• Created as a lightweight alternative to other music display solutions