Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/NextFire/apple-music-discord-rpc
🎵 Discord Rich Presence Client for the macOS Apple Music app and iTunes
https://github.com/NextFire/apple-music-discord-rpc
apple-music deno discord itunes jxa macos
Last synced: 8 days ago
JSON representation
🎵 Discord Rich Presence Client for the macOS Apple Music app and iTunes
- Host: GitHub
- URL: https://github.com/NextFire/apple-music-discord-rpc
- Owner: NextFire
- License: mit
- Created: 2020-11-05T14:30:33.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-10-10T18:00:20.000Z (about 1 month ago)
- Last Synced: 2024-10-29T17:28:10.783Z (11 days ago)
- Topics: apple-music, deno, discord, itunes, jxa, macos
- Language: TypeScript
- Homepage:
- Size: 98.6 KB
- Stars: 576
- Watchers: 12
- Forks: 39
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-discord-activities - apple-music-discord-rpc - Discord Rich Presence Client for the macOS Apple Music app and iTunes (Music)
README
# apple-music-discord-rpc
**[Deno](https://deno.com) + 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](https://github.com/NextFire/apple-music-discord-rpc/pull/5))
- MusicBrainz artwork fallback ([#66](https://github.com/NextFire/apple-music-discord-rpc/pull/66))
## 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](https://brew.sh), 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](https://github.com/NextFire/homebrew-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](https://deno.com) (v2+), clone the repository and execute [`install.sh`](/scripts/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](/scripts/moe.yuru.music-rpc.plist) into `~/Library/LaunchAgents/` and edit it accordingly.
#### Uninstall
```
cd apple-music-discord-rpc/
./scripts/uninstall.sh
cd ../
rm -rf apple-music-discord-rpc/
```