AppleMusicDecryptV2 Setup Guide (WSL)


LEGAL DISCLAIMER: READ CAREFULLY

DISCLAIMER This project is strictly for educational and security research purposes only. It demonstrates interaction with the Apple Music API and decryption wrappers.

  • DO NOT use this tool to distribute copyrighted music.
  • DO NOT use this tool to bypass subscription fees. A valid subscription is required.
  • Usage of this tool likely violates Apple's Terms of Service and may lead to account bans.
  • The developer is not responsible for any legal or personal consequences. Use at your own risk.

Index


1. Mandatory Pre-requisites

A. BIOS Virtualization

You must enable hardware virtualization in your firmware before Windows can run Linux.

  1. Reboot and enter BIOS/UEFI (usually F2, F10, F12, or DEL).
  2. Locate Processor, CPU Configuration, or Advanced.
  3. Enable Virtualization:
    • Intel: Enable "Intel Virtualization Technology" or "VT-x".
    • AMD: Enable "SVM Mode" or "AMD-V".
  4. Save and Exit (F10).

B. Windows Features (PowerShell)

Run PowerShell as Administrator and execute these commands to enable the subsystem:

1
2
3
4
5
6
# Enable WSL, Virtual Machine Platform, and Hyper-V
dism.exe /online /enable-feature /featurename:Microsoft-Hyper-V-All /all /norestart
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
# Reboot to apply changes
Restart-Computer

2. Install WSL & Ubuntu

  1. Install & Update WSL:
    wsl --install
    wsl --update
    
  2. Install Ubuntu:
    wsl --install -d Ubuntu
    
  3. Launch Ubuntu:
    Type Ubuntu in your start menu or PowerShell. Follow the on-screen prompts to create your Linux Username and Password.

3. Environment Setup

Inside your Ubuntu terminal, run the following:

  1. Update System & Install Go:
    sudo apt update -y && sudo apt upgrade -y && sudo apt install golang -y
    
  2. Clone Project:
    git clone https://github.com/WorldObservationLog/AppleMusicDecrypt.git && cd AppleMusicDecrypt
    
  3. Install Poetry (Python Manager):
    curl -sSL https://install.python-poetry.org | python3 -
    
  4. Install Dependencies:
    sudo chmod +x tools/install-deps.sh && sudo ./tools/install-deps.sh && poetry install
    

4. Configuration

  1. Create Config File:
    cp config.example.toml config.toml && nano config.toml
    
  2. Edit config.toml:
    • Set your language.
    • Set your download output folder to (c is the drive letter and Admin is your Windows Username. Replace for your use case) :
      dirPathFormat = "/mnt/c/Users/Admin/Music/albums/{album_artist}/{album}"
      playlistDirPathFormat = "/mnt/c/Users/Admin/Music/playlists/{playlistName}"
      
    • Edit the file options as you wish.
  3. Save & Exit: CTRL+S then CTRL+X.

5. Setting up the Wrapper

  1. Download & Build:
    1
    2
    3
    cd ..
    git clone https://github.com/WorldObservationLog/wrapper-manager && cd wrapper-manager
    go mod tidy && go build
    
  2. Run Wrapper (Keep this window open):
    sudo ./wrapper-manager
    

6. First Startup & Usage

  1. Open a SECOND Ubuntu Window (Keep the wrapper running in the first one).
  2. Run the App:
    cd AppleMusicDecrypt
    poetry run python main.py
    
  3. Login:
    Type login and enter your credentials.
  4. Download Commands:
    • dl [URL] — Basic download.
    • dl -c [codec] [URL] — Specify codec (e.g., atmos, aac).
    • dl -f [URL] — Force overwrite.

Credits

WorldObservationLog, zhaarey, Sorrow & itouakirai Tutorial made by 0daxelagnia

If eveything worked fine, i'll kindly ask you to donate to my PayPal here! I also accept crypto! BEP20: 0x1c5fdc133c010de89e5feb2bc93639b73e71e997 Thank you and enjoy music!

Edit

Pub: 10 Dec 2025 02:06 UTC

Edit: 19 Dec 2025 16:32 UTC

Views: 410

Auto Theme: Dark