apmyx

A GUI-based Apple Music downloader for Atmos, Lossless, and AAC formats (needs to be built from source for MacOS, Linux).

Get the latest Windows app from releases. Please refer to the Installation section before starting the GUI to avoid any errors.

About

Easily download playlists, songs, albums, and artist discographies up to Lossless 24-bit/192kHz, and music videos up to 4K.

Music videos, lyrics, AAC LC 256 only need a token, no wrapper required.
ALAC, Atmos, AAC Binaural, Downmix require the wrapper. Setup guide for MacOS / Windows. (Additional MacOS guide)

Features

Easy Search - search songs and artists directly in the app.

Quality Selection - check available audio qualities before downloading.

Artist Discography - download a full discography with one click.

Lyrics Sync - sync your music library with lyrics.

Selective Downloads - pick specific tracks, albums, or music videos.

Requirements

An active Apple Music subscription
mp4box - required for music video muxing and song/video tagging
mp4decrypt - required for music video downloads
FFmpeg - required for animated artwork

Make sure all three tools are added to your system PATH. Restart your computer after doing so.

Getting Your Media User Token

Method 1: Developer Tools

Open music.apple.com and log in.
Open DevTools (Ctrl+Shift+I / Cmd+Option+I).
Go to Application -> Storage -> Cookies -> https://music.apple.com.
Find media-user-token and copy its value.

Method 2: Cookie Export Extension

Install Get cookies.txt LOCALLY (Chrome) or Export Cookies (Firefox), export cookies from music.apple.com, and copy the value next to media-user-token.

Note: Paste the token exactly as-is with no leading or trailing spaces. Extra spaces will cause errors. You can also set it manually in config.yaml.

Installation

Download the latest release from Releases and extract it.
Run apmyx.exe.
Enter your media user token in settings.

Wrapper Installation (Windows)

Only needed for ALAC, Atmos, AAC Binaural, AAC Downmix.

Download and extract AMDL WSL1 ALL IN ONE.zip.
Run 0-1 Install WSL1(need to reboot later).bat and restart your computer.
Run 0-2 Install Ubuntu-AMDL(only once).bat.
Open 1. Run decryptor (!!!need to replace username and password in this file).bat in Notepad, replace username:password with your Apple Music credentials (enclose in quotes, e.g. "email@example.com:password"), save, and run it.
Wait for response type 6 and listening status and keep this window open while using apmyx.

Then download and run apmyx.exe from releases, or run from source:

git clone https://github.com/rwnk-12/apmyx-gui.git
cd apmyx-gui
pip install -r requirements.txt
cd src
python main.py

Wrapper Installation (MacOS)

Only needed for ALAC, Atmos, AAC Binaural, AAC Downmix.

Step 1: Install Dependencies

brew install go gpac git docker

Step 2: Login

Replace username:password with your Apple Music credentials (username = email).

docker run -v ./rootfs/data:/app/rootfs/data -e args="-L username:password -F" --rm ghcr.io/itouakirai/wrapper:x86

If 2FA is enabled, enter the verification code when prompted. A response of type 6 means login was successful.

Step 3: Start the Wrapper

Keep this window open while using apmyx.

docker run -v ./rootfs/data:/app/rootfs/data -p 10020:10020 -p 20020:20020 -e args="-M 20020 -H 0.0.0.0" --rm ghcr.io/itouakirai/wrapper:x86

Step 4: Start apmyx

git clone https://github.com/rwnk-12/apmyx-gui.git
cd apmyx-gui
pip install -r requirements.txt
cd src
python main.py

Wrapper steps 1-3 are based on the guide by itouakirai. For wrapper issues, open an issue here. For another detailed MacOS guide, see this gist.

Building from Source

Prerequisites: Go 1.18+, Python 3.9+, FFmpeg, mp4box, mp4decrypt.

git clone https://github.com/rwnk-12/apmyx-gui.git
cd apmyx-gui/scripts

# Build Go backend
chmod +x build_go.sh
./build_go.sh

# Set up Python environment
python -m venv venv
source venv/bin/activate        # macOS/Linux
# .\venv\Scripts\activate       # Windows
pip install -r requirements.txt

# Run the app
cd src
python main.py

Support

For issues or questions, open an issue on GitHub.