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: 4 months 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 (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-02-25T22:59:07.000Z (4 months ago)
- Last Synced: 2024-02-26T21:42:17.946Z (4 months ago)
- Topics: apple-music, deno, discord, itunes, jxa, macos
- Language: TypeScript
- Homepage:
- Size: 96.7 KB
- Stars: 428
- Watchers: 11
- Forks: 29
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-discord-activities - apple-music-discord-rpc - Discord Rich Presence Client for the macOS Apple Music app and iTunes (Music)
- awesome-stars - NextFire/apple-music-discord-rpc - π΅ Discord Rich Presence Client for the macOS Apple Music app and iTunes (TypeScript)
README
# apple-music-discord-rpc
**[Deno](https://deno.land) + 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 be launched in background at login.
- No status bar icon clutter.
- Presence is only enabled when actually playing something.
- Apple Music matching ([#5](https://github.com/NextFire/apple-music-discord-rpc/pull/5)).
- Spotify search button ([#59](https://github.com/NextFire/apple-music-discord-rpc/pull/59)).
- MusicBrainz artwork fallback ([#66](https://github.com/NextFire/apple-music-discord-rpc/pull/66))
## Getting Started
Choose one of the two methods below to install the script and enable the macOS launch agent that starts it on 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.land), 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/
```