Home

Awesome

Glomatico's Apple Music Downloader

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

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

Features

Prerequisites

Optional dependencies

The following tools are optional but required for specific features. Add them to your system’s PATH or specify their paths using command-line arguments or the config file.

Installation

  1. Install the package gamdl using pip 
    pip install gamdl
  2. Set up the cookies file.
    • You can either move to the current directory from which you will be running Gamdl as cookies.txt or specify its path using the command-line arguments/config file.

Usage

gamdl [OPTIONS] URLS...

Supported URL types

Gamdl supports the following types of URLs:

Examples

Interactive prompt controls

Configuration

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

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

Config file values can be overridden using command line arguments.

Command line argument / Config file keyDescriptionDefault value
--disable-music-video-skip / disable_music_video_skipDon't skip downloading music videos in albums/playlists.false
--save-cover, -s / save_coverSave cover as a separate file.false
--overwrite / overwriteOverwrite existing files.false
--read-urls-as-txt, -r / -Interpret URLs as paths to text files containing URLs separated by newlines.false
--save-playlist / save_playlistSave a M3U8 playlist file when downloading a playlist.false
--synced-lyrics-only / synced_lyrics_onlyDownload only the synced lyrics.false
--no-synced-lyrics / no_synced_lyricsDon't download the synced lyrics.false
--config-path / -Path to config file.<home>/.gamdl/config.json
--log-level / log_levelLog level.INFO
--no-exceptions / no_exceptionsDon't print exceptions.false
--cookies-path, -c / cookies_pathPath to .txt cookies file../cookies.txt
--language, -l / languageMetadata language as an ISO-2A language code (don't always work for videos).en-US
--output-path, -o / output_pathPath to output directory../Apple Music
--temp-path / temp_pathPath to temporary directory../temp
--wvd-path / wvd_pathPath to .wvd file.null
--nm3u8dlre-path / nm3u8dlre_pathPath to N_m3u8DL-RE binary.N_m3u8DL-RE
--mp4decrypt-path / mp4decrypt_pathPath to mp4decrypt binary.mp4decrypt
--ffmpeg-path / ffmpeg_pathPath to FFmpeg binary.ffmpeg
--mp4box-path / mp4box_pathPath to MP4Box binary.MP4Box
--download-mode / download_modeDownload mode.ytdlp
--remux-mode / remux_modeRemux mode.ffmpeg
--cover-format / cover_formatCover format.jpg
--template-folder-album / template_folder_albumTemplate folder for tracks that are part of an album.{album_artist}/{album}
--template-folder-compilation / template_folder_compilationTemplate folder for tracks that are part of a compilation album.Compilations/{album}
--template-file-single-disc / template_file_single_discTemplate file for the tracks that are part of a single-disc album.{track:02d} {title}
--template-file-multi-disc / template_file_multi_discTemplate file for the tracks that are part of a multi-disc album.{disc}-{track:02d} {title}
--template-folder-no-album / template_folder_no_albumTemplate folder for the tracks that are not part of an album.{artist}/Unknown Album
--template-file-no-album / template_file_no_albumTemplate file for the tracks that are not part of an album.{title}
--template-file-playlist / template_file_playlistTemplate file for the M3U8 playlist.Playlists/{playlist_title}
--template-date / template_dateDate tag template.%Y-%m-%dT%H:%M:%SZ
--exclude-tags / exclude_tagsComma-separated tags to exclude.null
--cover-size / cover_sizeCover size.1200
--truncate / truncateMaximum length of the file/folder names.null
--codec-song / codec_songSong codec.aac-legacy
--synced-lyrics-format / synced_lyrics_formatSynced lyrics format.lrc
--codec-music-video / codec_music_videoMusic video codec.h264
--quality-post / quality_postPost video quality.best
--no-config-file, -n / -Do not use a config file.false

Tags variables

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

Remux modes

The following remux modes are available:

Download modes

The following download modes are available:

Song codecs

The following codecs are available:

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:

Music videos codecs

The following codecs are available:

Post videos/extra videos qualities

The following qualities are available:

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

Synced lyrics formats

The following synced lyrics formats are available:

Cover formats

The following cover formats are available: