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: about 17 hours 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 (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-08-30T18:05:55.000Z (26 days ago)
- Last Synced: 2024-09-20T12:21:27.378Z (5 days ago)
- Topics: apple-music, deno, discord, itunes, jxa, macos
- Language: TypeScript
- Homepage:
- Size: 93.8 KB
- Stars: 546
- Watchers: 12
- Forks: 35
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
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 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.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/
```