AppleMusicDL

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 14 Open GitHub ↗

Download Apple Music tracks in ALAC (Apple Lossless) format using Python and Frida. For personal use only.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1>AppleMusicDL</h1>

<p><strong>Rip Apple Music tracks in lossless ALAC — straight to your drive.</strong></p>

[![Python](https://img.shields.io/badge/Python-3.8+-3776ab?style=for-the-badge&logo=python&logoColor=white)](https://python.org)
[![Frida](https://img.shields.io/badge/Frida-16.0+-ff6b35?style=for-the-badge)](https://frida.re)
[![License](https://img.shields.io/badge/License-MPL%202.0-fc5c7d?style=for-the-badge)](https://raw.githubusercontent.com/vaultdmn/AppleMusicDL/main/LICENSE)
[![Format](https://img.shields.io/badge/Format-ALAC%20%2F%20M4A-c0392b?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/w3Abhishek/AppleMusicDL)
[![Stars](https://img.shields.io/github/stars/w3Abhishek/AppleMusicDL?style=for-the-badge&color=fc5c7d&logo=github)](https://github.com/w3Abhishek/AppleMusicDL/stargazers)
[![Issues](https://img.shields.io/github/issues/w3Abhishek/AppleMusicDL?style=for-the-badge&color=c0392b)](https://github.com/w3Abhishek/AppleMusicDL/issues)

<br/>

> ⚠️ **Personal use only.** This tool is for music you have the right to access.
> Downloading copyrighted content may violate Apple's ToS and local copyright laws.

</div>

---

## ✨ What it does

AppleMusicDL downloads tracks from Apple Music in **ALAC (Apple Lossless Audio Codec)** format — the same lossless quality Apple streams — with complete iTunes metadata embedded. No lossy compression, no missing tags, no manual work.

```
Apple Music  →  Frida (FairPlay decrypt)  →  .m4a (ALAC + metadata)
```

**What you get:**
- Lossless ALAC audio, exactly as streamed
- Full metadata — title, artist, album, year, composer, ISRC, UPC
- Album artwork embedded + saved separately
- Automatically organized folder structure

---

## 🔬 How it works

| Step | What happens |
|------|-------------|
| 1 | Extracts bearer token from Apple Music web interface |
| 2 | Fetches album + track metadata via Apple Music API |
| 3 | Parses M3U8 playlists to locate ALAC streams |
| 4 | Downloads encrypted fragmented MP4 segments |
| 5 | Sends encrypted samples to Frida agent on Android emulator |
| 6 | Frida hooks FairPlay, decrypts and returns raw audio |
| 7 | Reconstructs complete `.m4a` with audio + metadata |

---

## 📋 Requirements

| Requirement | Details |
|------------|---------|
| Python | 3.8 or higher |
| Android Studio | With Android Emulator (no Google APIs image) |
| ADB | Android Debug Bridge |
| Frida | `frida` + `frida-tools` matching versions |
| Apple Music | Active subscription required |
| APK | Apple Music 3.6.0 Beta ([APKMirror](https://www.apkmirror.com/apk/apple/apple-music/apple-music-3-6-0-beta-release/apple-music-3-6-0-beta-4-android-apk-download/)) |

---

## 🚀 Setup

### 1 · Clone and install

```bash
git clone https://github.com/w3Abhishek/AppleMusicDL.git
cd AppleMusicDL
pip install -r requirements.txt
```

### 2 · Set up Android emulator

1. Open Android Studio → create a virtual device
   - Use an image **without Google APIs** (required for Frida)
   - Recommended: **Android 10 (API 29)** or Android 11 (API 30)
2. Install [SAI (Split APKs Installer)](https://f-droid.org/packages/com.aefyr.sai.fdroid/) on the emulator
3. Use SAI to install the **Apple Music 3.6.0 Beta** APK
4. Sign in with your Apple ID (subscription required)

### 3 · Set up Frida

```bash
# Check your installed version
frida --version

# Download matching frida-server for x86_64 emulator
# Replace <version> with your frida version
wget https://github.com/frida/frida/releases/download/<version>/frida-server-<version>-android-x86_64.xz
unxz frida-server-<version>-android-x86_64.xz

# Push to emulator and start
adb root
adb push frida-server-<version>-android-x86_64 /data/local/tmp/frida-server
adb shell "chmod 755 /data/local/tmp/frida-server"
adb shell "/data/local/tmp/frida-server &"

# Confirm it's running
frida-ps -U
```

### 4 · Port forwarding

```bash
adb forward tcp:10020 tcp:10020
```

---

## 🎵 Usage

**Step 1** — Start the Frida agent and keep it running:

```bash
frida -U -l agent.js -f com.apple.android.music
```

**Step 2** — Download an album:

```bash
python main.py https://music.apple.com/us/album/album-name/1624945511
```

**Multiple albums at once:**

```bash
python main.py \
  https://music.apple.com/us/album/album1/123456 \
  https://music.apple.com/us/album/album2/789012
```

**Output:**

```
AM-DL downloads/
└── Artist Name - Album Name/
    ├── cover.jpg
    ├── 01. Track Name.m4a
    ├── 02. Track Name.m4a
    └── ...
```

---

## 🗂 Project structure

```
AppleMusicDL/
├── apple_music_dl/
│   ├── api.py           # Apple Music API client + auth
│   ├── m3u8_parser.py   # Stream URL + encryption key extraction
│   ├── mp4_handler.py   # Fragmented MP4 parsing + ALAC params
│   ├── decryptor.py     # Frida socket communication
│   ├── metadata.py      # iTunes metadata + M4A reconstruction
│   ├── models.py        # Data models
│   └── utils.py         # Helpers
├── agent.js             # Frida agent (JavaScript, runs on emulator)
├── main.py              # Entry point
└── requirements.txt
```

---

## 🔧 Troubleshooting

<details>
<summary><strong>Failed to connect to Frida agent</strong></summary>

```bash
adb shell ps | grep frida        # verify server is running
adb forward tcp:10020 tcp:10020  # re-apply port forward
frida-ps -U                      # list processes, confirm ADB sees emulator
```
</details>

<details>
<summary><strong>Unavailable in ALAC</strong></summary>

Some tracks are not available in lossless in all regions. Try switching your Apple Music storefront or check if the album has a lossless badge in the app.
</details>

<details>
<summary><strong>Failed to get token</strong></summary>

Apple occasionally changes their web interface structure. Open an issue with your full error log and Python version.
</details>

<details>
<summary><strong>Decryption size mismatch</strong></summary>

The encryption key list doesn't match the sample count. Re-run the download. If it persists, check Frida agent output for errors.
</details>

---

## 🤝 Contributing

1. Fork the repo
2. Create a feature branch (`git checkout -b feat/your-feature`)
3. Write tests for your changes
4. Open a pull request

Bug reports with full logs and Python version are always welcome.

---

## 📄 License

[Mozilla Public License 2.0](LICENSE) — open source, share-alike for modifications.

---

<div align="center">
<sub>Built with 🎵 for audiophiles who hate lossy compression</sub>
</div>

AppleMusicDL

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README