Skip to content

rwnk-12/apmyx-gui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

80 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

Features

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

v1-main

Quality Selection - check available audio qualities before downloading.

quality

Artist Discography - download a full discography with one click.

artist_page

Lyrics Sync - sync your music library with lyrics.

lyrics

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

select

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

  1. Open music.apple.com and log in.
  2. Open DevTools (Ctrl+Shift+I / Cmd+Option+I).
  3. Go to Application -> Storage -> Cookies -> https://music.apple.com.
  4. 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

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

Wrapper Installation (Windows)

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

  1. Download and extract AMDL WSL1 ALL IN ONE.zip.
  2. Run 0-1 Install WSL1(need to reboot later).bat and restart your computer.
  3. Run 0-2 Install Ubuntu-AMDL(only once).bat.
  4. 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.
  5. 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.

Credits & References