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.
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)
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.
- 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.
- 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-tokenand copy its value.
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.
- Download the latest release from Releases and extract it.
- Run
apmyx.exe. - Enter your media user token in settings.
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).batand 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).batin Notepad, replaceusername:passwordwith your Apple Music credentials (enclose in quotes, e.g."email@example.com:password"), save, and run it. - Wait for
response type 6 and listening statusand 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.pyOnly needed for ALAC, Atmos, AAC Binaural, AAC Downmix.
brew install go gpac git dockerReplace 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:x86If 2FA is enabled, enter the verification code when prompted. A response of type 6 means login was successful.
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:x86git clone https://github.com/rwnk-12/apmyx-gui.git
cd apmyx-gui
pip install -r requirements.txt
cd src
python main.pyWrapper 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.
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.pyFor issues or questions, open an issue on GitHub.