A Python CLI app for downloading Apple Music songs, music videos and post videos.
Join our Discord Server: https://discord.gg/aBjMEZ9tnq
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.
mp4box remux mode, music video downloads, and experimental song codecs.mp4box remux mode.nm3u8dlre download mode.gamdl using pip
pip install gamdl
cookies.txt.Run Gamdl with the following command:
gamdl [OPTIONS] URLS...
gamdl "https://music.apple.com/us/album/never-gonna-give-you-up-2022-remaster/1624945511?i=1624945512"
gamdl "https://music.apple.com/us/album/whenever-you-need-somebody-2022-remaster/1624945511"
gamdl "https://music.apple.com/us/artist/rick-astley/669771"
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 key | Description | Default value |
|---|---|---|
--disable-music-video-skip / disable_music_video_skip | Don't skip downloading music videos in albums/playlists. | false |
--save-cover, -s / save_cover | Save cover as a separate file. | false |
--overwrite / overwrite | Overwrite existing files. | false |
--read-urls-as-txt, -r / - | Interpret URLs as paths to text files containing URLs separated by newlines. | false |
--save-playlist / save_playlist | Save a M3U8 playlist file when downloading a playlist. | false |
--synced-lyrics-only / synced_lyrics_only | Download only the synced lyrics. | false |
--no-synced-lyrics / no_synced_lyrics | Don't download the synced lyrics. | false |
--config-path / - | Path to config file. | <home>/.gamdl/config.json |
--log-level / log_level | Log level. | INFO |
--no-exceptions / no_exceptions | Don't print exceptions. | false |
--cookies-path, -c / cookies_path | Path to .txt cookies file. | ./cookies.txt |
--language, -l / language | Metadata language as an ISO-2A language code (don't always work for videos). | en-US |
--output-path, -o / output_path | Path to output directory. | ./Apple Music |
--temp-path / temp_path | Path to temporary directory. | ./temp |
--wvd-path / wvd_path | Path to .wvd file. | null |
--nm3u8dlre-path / nm3u8dlre_path | Path to N_m3u8DL-RE binary. | N_m3u8DL-RE |
--mp4decrypt-path / mp4decrypt_path | Path to mp4decrypt binary. | mp4decrypt |
--ffmpeg-path / ffmpeg_path | Path to FFmpeg binary. | ffmpeg |
--mp4box-path / mp4box_path | Path to MP4Box binary. | MP4Box |
--download-mode / download_mode | Download mode. | ytdlp |
--remux-mode / remux_mode | Remux mode. | ffmpeg |
--cover-format / cover_format | Cover format. | jpg |
--template-folder-album / template_folder_album | Template folder for tracks that are part of an album. | {album_artist}/{album} |
--template-folder-compilation / template_folder_compilation | Template folder for tracks that are part of a compilation album. | Compilations/{album} |
--template-file-single-disc / template_file_single_disc | Template file for the tracks that are part of a single-disc album. | {track:02d} {title} |
--template-file-multi-disc / template_file_multi_disc | Template file for the tracks that are part of a multi-disc album. | {disc}-{track:02d} {title} |
--template-folder-no-album / template_folder_no_album | Template folder for the tracks that are not part of an album. | {artist}/Unknown Album |
--template-file-no-album / template_file_no_album | Template file for the tracks that are not part of an album. | {title} |
--template-file-playlist / template_file_playlist | Template file for the M3U8 playlist. | Playlists/{playlist_title} |
--template-date / template_date | Date tag template. | %Y-%m-%dT%H:%M:%SZ |
--exclude-tags / exclude_tags | Comma-separated tags to exclude. | null |
--cover-size / cover_size | Cover size. | 1200 |
--truncate / truncate | Maximum length of the file/folder names. | null |
--codec-song / codec_song | Song codec. | aac-legacy |
--synced-lyrics-format / synced_lyrics_format | Synced lyrics format. | lrc |
--codec-music-video / codec_music_video | Music video codec. | h264 |
--quality-post / quality_post | Post video quality. | best |
--no-config-file, -n / - | Do not use a config file. | false |
The following variables can be used in the template folders/files and/or in the exclude_tags list:
albumalbum_artistalbum_idalbum_sortartistartist_idartist_sortcommentcompilationcomposercomposer_idcomposer_sortcopyrightcoverdatediscdisc_totalgaplessgenregenre_idlyricsmedia_typeplaylist_artistplaylist_idplaylist_titleplaylist_trackratingstorefronttitletitle_idtitle_sorttracktrack_totalxidffmpeg: Default remuxing mode.mp4box: Alternative remuxing mode (doesn’t convert closed captions in music videos).ytdlp: Default download mode.nm3u8dlre: Faster than ytdlp.aac-legacy: AAC 256kbps 44.1kHz.aac-he-legacy: AAC-HE 64kbps 44.1kHz.aac: AAC 256kbps up to 48kHz.aac-he: AAC-HE 64kbps up to 48kHz.aac-binaural: AAC 256kbps binaural.aac-downmix: AAC 256kbps downmix.aac-he-binaural: AAC-HE 64kbps binaural.aac-he-downmix: AAC-HE 64kbps downmix.atmos: Dolby Atmos 768kbps.ac3: AC3 640kbps.alac: ALAC up to 24-bit/192 kHz.ask: Prompt to choose available audio codec.h264: Up to 1080p with AAC 256kbps.h265: Up to 2160p with AAC 256kpbs.ask: Prompt to choose available video and audio codecs.best: Up to 1080p with AAC 256kbps.ask: Prompt to choose available video quality.lrc: Lightweight and widely supported.srt: SubRip format (has more accurate timestamps).ttml: Native Apple Music format (unsupported by most media players).jpg: Default format.png: Lossless format.raw: Raw cover without processing (requires save_cover to save separately).FAQs
A Python CLI app for downloading Apple Music songs, music videos and post videos.
We found that gamdl demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Security experts warn that recent classification changes obscure the true scope of the NVD backlog as CVE volume hits all-time highs.
Security Fundamentals
Attackers use obfuscation to hide malware in open source packages. Learn how to spot these techniques across npm, PyPI, Maven, and more.
Security News
Join Socket for exclusive networking events, rooftop gatherings, and one-on-one meetings during BSidesSF and RSA 2025 in San Francisco.