Simpler Wrapper Guide with more information

The person who wrote this guide is "@alacdecoder - TG"

The person who adding, collect more guide and format this rentry for note, more information and such

Change logs


Dependencies

1
2
3
sudo apt update -y
sudo apt upgrade -y
sudo apt install -y wget git unzip golang gpac ffmpeg

Wrapper

1
2
3
4
cd ~
wget -P ~ https://github.com/itouakirai/wrapper/releases/download/Wrapper.x86_64.f907010/Wrapper.x86_64.f907010.zip
unzip ~/Wrapper.x86_64.*.zip -d ~/wrapper
rm ~/Wrapper.x86_64.*.zip

Downloader

1
2
3
4
cd ~
git clone https://github.com/zhaarey/apple-music-downloader downloader
cd ~/downloader
go build

Run wrapper (Terminal 1)

cd ~/wrapper
sudo ./wrapper -M 20020 -L email:password

Or for trying like this:

sudo ./wrapper -M 20020 -L "email":"password"

Run downloader (Terminal 2)

cd ~/downloader
./main [album-link]

Original guide

For full setup and build


Additional Note:

  • For android user
  • For Windows user, you need to set up WSL (Ubuntu 24.04) first

    Usage of WSL will cause Virtual Disk become heavy overtime, so here is an guide to shrink it - Recommended from @G.Foster

  • For MacOS user
  • This guide does not include the dependencies needed for downloading Music Videos (MV).
  • If 2fa turn on, you on your own
  • In order to obtain lyrics file, you need to set-up media-user-token (using extension like EditThisCookie or using F12 in the website page)
  • Do not use shared account

Known error

Few note

These are just some known errors and how to fix them, some are unknown how to fix them.

  1. If you can't log into Wrapper even using "email":"password", check your password to see if it's on the list causing problems with Terminal.
  2. Error code: 0 means the song does not exist.
  3. Error Decrypt - 3 cases:
    1. You do not run Wrapper in the background.
    2. You have downloading too much, close Wrapper with Ctrl + C and take a break for five to ten minutes. Or restart your computer.
    3. This is why it is not recommended to use a shared account, because you cannot listen to music and download at the same time. AM only allows one stream to run.
  4. Failed to extract info from manifest: no codec found - 2 cases:
    1. You trying to download dolby atmos, which is not have in that album.
    2. If you desire to download audio file have lowest sample rate (such as 44100khz), and AM doesn't have. You must run ./main --debug [url] to check what lowest quality AM have.
Edit Report
Pub: 09 May 2025 03:44 UTC
Edit: 20 May 2025 22:53 UTC
Views: 941
Auto Theme: Dark