/apple-music-rpc

🎵 Discord Rich Presence Client for the macOS Apple Music app and iTunes

Primary LanguageTypeScriptMIT LicenseMIT

apple-music-discord-rpc

Deno + JavaScript for Automation (JXA) Discord Rich Presence Client for the macOS Apple Music app (Catalina and later) and legacy iTunes.

Works with local tracks and Apple Music streaming service.

Features

  • Can start in background at login
  • No status bar icon clutter
  • Small and (quite) easy to understand script
  • Presence is only enabled when actually playing something
  • Apple Music matching (#5)
  • MusicBrainz artwork fallback (#66)
Screenshot 2024-08-29 at 20 05 10

Getting Started

Follow one of the two sections below to download the script and enable the macOS launch agent that will start it at login.

Homebrew (Recommended)

Install

After installing Homebrew, execute the following commands:

brew tap nextfire/tap
brew install apple-music-discord-rpc
brew services restart apple-music-discord-rpc

These commands

  • add this tap to Homebrew,
  • install its apple-music-discord-rpc formula (and Deno),
  • enable the launch agent and start it immediately.

The music-rpc.ts executable is now also in PATH.

Uninstall

brew services stop apple-music-discord-rpc
brew remove apple-music-discord-rpc
brew untap nextfire/tap

Shell Scripts

Install

Install Deno (v2+), clone the repository and execute install.sh:

git clone https://github.com/NextFire/apple-music-discord-rpc.git
cd apple-music-discord-rpc/
./scripts/install.sh

It will copy the launch agent into ~/Library/LaunchAgents/ and edit it accordingly.

Uninstall

cd apple-music-discord-rpc/
./scripts/uninstall.sh
cd ../
rm -rf apple-music-discord-rpc/