KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #claude-code #codex #cli #agent-skills #ai #dsh-plugin #mcp #windows #agent

apple-music-api

★ 46 Open GitHub ↗

ALAC music download & decrypt

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# apple-music-api

Apple Music daemon for `x86_64-linux-android`.

This project boots an Android Apple Music runtime, exposes a small HTTP service, and supports local playback decryption plus a Subsonic-compatible interface. API details, request parameters, and response examples live in [`API.md`](./API.md).

>[!TIP]
>
> Full lyrics require `MEDIA_USER_TOKEN`. In this daemon, provide it with `--media-user-token` or `WRAPPER_MEDIA_USER_TOKEN`.

>[!WARNING]
>
> Using Apple Music in an unofficial or non-standard environment to download songs may trigger account enforcement, including suspension or termination.

>[!IMPORTANT]
>
> This project is provided for research and personal interoperability purposes only. You assume all responsibility for compliance with Apple Music terms, local law, and any account or data risk that follows from using it.

## Deployment

### Runtime requirements

- Android Apple Music runtime libraries
- persistent app data at `/data/data/com.apple.android.music`
- `ffmpeg` and `ffprobe` at `/usr/local/bin`
- required startup flag: `--api-token`

The default runtime base directory is `/data/data/com.apple.android.music/files`. Persisting the parent directory is enough for login state and runtime data.

### Docker

The repository includes a multi-stage [Dockerfile](./Dockerfile) and CI publishes:

```text
ghcr.io/lbr77/apple-music-api:latest
```

Example:

```bash
docker run --rm -p 8080:8080 \
  -v ./persist/com.apple.android.music:/data/data/com.apple.android.music \
  ghcr.io/lbr77/apple-music-api:latest \
  --host 0.0.0.0 \
  --daemon-port 8080 \
  --api-token local-dev-token
```

Subsonic clients use `/rest/*` with Subsonic credentials from `SUBSONIC_USERNAME` and
`SUBSONIC_PASSWORD`. That surface accepts standard Subsonic query auth and does not use the
daemon Bearer token.

The daemon also serves a minimal web UI at `/app/`. The UI has two screens:

- a Bearer token page
- a settings page for Apple Music login, 2FA, and logout

## Local build

The workspace targets `x86_64-linux-android` by default.

```bash
rustup target add x86_64-linux-android
cargo install --locked cargo-ndk

export ANDROID_NDK_HOME=/path/to/android-ndk
cargo ndk -t x86_64 build --release --bin main
```

Output:

```text
target/x86_64-linux-android/release/main
```

### Frontend bundle

The frontend lives in [`frontend/`](./frontend) and is bundled into the daemon binary from `frontend/dist`.

```bash
cd frontend
npm install
npm run build
```

Use [`API.md`](./API.md) for login flow, route list, request examples, Subsonic usage, and cache behavior.

apple-music-api

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README