Glomatico's ✨ Apple Music ✨ Downloader

A Python script to download Apple Music songs/music videos/albums/playlists.

This is a rework of https://github.com/loveyoursupport/AppleMusic-Downloader/tree/661a274d62586b521feec5a7de6bee0e230fdb7d.

Some new features that I added:

• MP4Box for muxing
• Tags for music videos
• Multiple URLs input
• iTunes folder structure
• Embedded lyrics and .lrc file
• Auto set region
• Playlist support
• And much more!

Setup

1. Install Python 3.7 or newer
2. Install gamdl with pip

   pip install gamdl
   

3. Add MP4Box and mp4decrypt to your PATH
   • You can get them from here:
     • MP4Box: https://gpac.wp.imt.fr/downloads/
     • mp4decrypt: https://www.bento4.com/downloads/
4. Export your Apple Music cookies as cookies.txt to the same folder that you will run the script
   • You can export your cookies by using this Google Chrome extension on Apple Music website: https://chrome.google.com/webstore/detail/open-cookiestxt/gdocmgbfkjnnpapoeobnolbbkoibbcif. Make sure to be logged in.
5. Put your Widevine Device file (.wvd) in the same folder that you will run the script
   • You can use Dumper to dump your phone's L3 CDM: https://github.com/Diazole/dumper. Once you have the L3 CDM, you can use pywidevine to create the .wvd file from it.
     1. Install pywidevine with pip

        pip install pywidevine pyyaml
        

     2. Create the .wvd file

        pywidevine create-device -t ANDROID -l 3 -k private_key.pem -c client_id.bin -o .
        

6. (optional) Add aria2c to your PATH for faster downloads
   • You can get it from here: https://github.com/aria2/aria2/releases.

Usage

usage: gamdl [-h] [-u [URLS_TXT]] [-w WVD_LOCATION] [-f FINAL_PATH] [-t TEMP_PATH] [-c COOKIES_LOCATION] [-m] [-p]
[-o] [-n] [-s] [-e] [-i] [-v]
[url ...]
Download Apple Music songs/music videos/albums/playlists
positional arguments:
url Apple Music song/music video/album/playlist URL(s) (default: None)
options:
-h, --help show this help message and exit
-u [URLS_TXT], --urls-txt [URLS_TXT]
Read URLs from a text file (default: None)
-w WVD_LOCATION, --wvd-location WVD_LOCATION
.wvd file location (default: *.wvd)
-f FINAL_PATH, --final-path FINAL_PATH
Final Path (default: Apple Music)
-t TEMP_PATH, --temp-path TEMP_PATH
Temp Path (default: temp)
-c COOKIES_LOCATION, --cookies-location COOKIES_LOCATION
Cookies location (default: cookies.txt)
-m, --disable-music-video-skip
Disable music video skip on playlists/albums (default: False)
-p, --prefer-hevc Prefer HEVC over AVC (default: False)
-o, --overwrite Overwrite existing files (default: False)
-n, --no-lrc Don't create .lrc file (default: False)
-s, --skip-cleanup Skip cleanup (default: False)
-e, --print-exceptions
Print execeptions (default: False)
-i, --print-video-m3u8-url
Print Video M3U8 URL (default: False)
-v, --version show program's version number and exit

Songs/Music Videos quality

• Songs:
  • 256kbps AAC
• Music Videos (varies depending on the video):
  • 4K HEVC 20mbps / AAC 256kbps
  • 4K HEVC 12mbps / AAC 256kbps
  • 1080p AVC 10mbps / AAC 256kbps
  • 1080p AVC 6.5bps / AAC 256kbps
  • 720p AVC 4mbps / AAC 256kbps
  • 480p AVC 1.5mbps / AAC 256kbps
  • 360p AVC 1mbps / AAC 256kbps

Some videos may include EIA-608 closed captions.