A Python CLI app for downloading Apple Music songs/music videos/posts.

Discord Server: https://discord.gg/aBjMEZ9tnq

• Download songs in AAC 256kbps and other codecs
• Download music videos up to 4K
• Download synced lyrics in LRC, SRT or TTML
• Choose between FFmpeg and MP4Box for remuxing
• Choose between yt-dlp and N_m3u8DL-RE for downloading
• Highly customizable
• Use artist links to download all of their albums or music videos

• Python 3.8 or higher
• The cookies file of your Apple Music browser session in Netscape format (requires an active subscription)
  • You can get your cookies by using one of the following extensions on your browser of choice at the Apple Music website with your account signed in:
    • Firefox: https://addons.mozilla.org/addon/export-cookies-txt
    • Chromium based browsers: https://chrome.google.com/webstore/detail/gdocmgbfkjnnpapoeobnolbbkoibbcif
• FFmpeg on your system PATH
  • Older versions of FFmpeg may not work.
  • Up to date binaries can be obtained from the links below:
    • Windows: https://github.com/AnimMouse/ffmpeg-stable-autobuild/releases
    • Linux: https://johnvansickle.com/ffmpeg/
• (Optional) mp4decrypt on your system PATH
  • Required to download music videos and songs in non-legacy formats.
  • Binaries can be obtained from here: https://www.bento4.com/downloads/.

1. Install the package custom_gamdl using pip

   pip install custom_gamdl

2. Place your cookies file in the directory from which you will be running custom_gamdl and name it cookies.txt.

custom_gamdl [OPTIONS] URLS...

• Download a song

  custom_gamdl "https://music.apple.com/us/album/never-gonna-give-you-up-2022-remaster/1624945511?i=1624945512"

• Download an album

  custom_gamdl "https://music.apple.com/us/album/whenever-you-need-somebody-2022-remaster/1624945511"

• Choose which albums or music videos to download from an artist

  custom_gamdl "https://music.apple.com/us/artist/rick-astley/669771"

• Arrow keys - Move selection
• Space - Toggle selection
• Ctrl + A - Select all
• Enter - Confirm selection

custom_gamdl can be configured by using the command line arguments or the config file.

The config file is created automatically when you run custom_gamdl for the first time at ~/.custom_gamdl/config.json on Linux and %USERPROFILE%\.custom_gamdl\config.json on Windows.

Config file values can be overridden using command line arguments.

The following variables can be used in the template folders/files and/or in the exclude_tags list:

• album
• album_artist
• album_id
• album_sort
• artist
• artist_id
• artist_sort
• comment
• compilation
• composer
• composer_id
• composer_sort
• copyright
• cover
• date
• disc
• disc_total
• gapless
• genre
• genre_id
• lyrics
• media_type
• playlist_artist
• playlist_id
• playlist_title
• playlist_track
• rating
• storefront
• title
• title_id
• title_sort
• track
• track_total
• xid

The following remux modes are available:

• ffmpeg
  • Can be used without mp4decrypt only for songs and when using legacy song codecs
• mp4box
  • Requires mp4decrypt
  • Doesn't convert closed captions in music videos that have them
  • Can be obtained from here: https://gpac.wp.imt.fr/downloads

The following download modes are available:

• ytdlp
• nm3u8dlre
  • Faster than ytdlp
  • Requires FFmpeg
  • Can be obtained from here: https://github.com/nilaoda/N_m3u8DL-RE/releases

The following codecs are available:

• aac-legacy
• aac-he-legacy

The following codecs are also available, but are not guaranteed to work, as currently most (or all) of the songs fails to be downloaded when using them:

• aac
• aac-he
• aac-binaural
• aac-downmix
• aac-he-binaural
• aac-he-downmix
• atmos
• ac3
• alac
• ask
  • When using this option, custom_gamdl will ask you which codec from this list to use that is available for the song.

The following codecs are available:

• h264 (up to 1080p, with AAC 256kbps)
• h265 (up to 2160p, with AAC 256kpbs)
• ask
  • When using this option, custom_gamdl will ask you which audio and video codec to use that is available for the music video.

The following qualities are available:

• best (up to 1080p, with AAC 256kbps)
• ask
  • When using this option, custom_gamdl will ask you which video quality to use that is available for the video.

Post videos doesn't require remuxing and are limited to ytdlp download mode.

The following synced lyrics formats are available:

• lrc
• srt
• ttml
  • Native format for Apple Music synced lyrics.
  • Highly unsupported by most media players.

The following cover formats are available:

• jpg
• png
• raw
  • This format gets the raw cover without any processing.
  • Note that when using this format, the cover image will not be embedded within the files. To address this, you can enable save_cover option to save the cover as a separate file.