gamdl

Gamdl (Glomatico's Apple Music Downloader)

A command-line app for downloading Apple Music songs, music videos and post videos.

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

✨ Features

• High-Quality Songs - Download songs in AAC 256kbps and other codecs
• High-Quality Music Videos - Download music videos in resolutions up to 4K
• Synced Lyrics - Download synced lyrics in LRC, SRT, or TTML formats
• ️ Rich Metadata - Automatic tagging with comprehensive metadata
• Artist Support - Download all albums or music videos from an artist
• ⚙️ Highly Customizable - Extensive configuration options for advanced users

Prerequisites

Required

• Python 3.10 or higher
• Active Apple Music subscription
• Apple Music Cookies - export your browser cookies in Netscape format while logged in at Apple Music:
  • Firefox: Export Cookies
  • Chromium: Get cookies.txt LOCALLY

Optional Dependencies

Wrapper

Run the Wrapper v2 server for wrapper-backed account, playback, and decryption requests. Enable it with --use-wrapper or use_wrapper = true. Configure wrapper HTTP account/playback calls with --wrapper-url or wrapper_url, and configure WV2D batch TCP decrypt with --wrapper-decrypt-host / --wrapper-decrypt-port.

gamdl builds a private Rust extension from gamdl/downloader/ammuxer as gamdl._ammuxer. That native media engine handles wrapper TCP decrypt/reassembly plus MP4/M4A writing and muxing; Python remains responsible for the CLI, downloads, metadata tagging, and high-level orchestration.

The wrapper is recommended when using the alac song codec. ALAC can be attempted without wrapper, but it probably won't work due to API limitations.

Note:

• When using the Wrapper, you'll be asked to insert your credentials to login if you haven't already.
• Newer wrapper-v2 builds use HTTP JSON for account/playback and WV2D batch TCP port 10020 for decrypt.
• Song codecs other than alac do not require the wrapper.
• Cookies can be skipped when using the wrapper.

N_m3u8DL-RE

Use N_m3u8DL-RE as a faster download alternative to the default yt-dlp download mode. Enable it with --download-mode nm3u8dlre or download_mode = nm3u8dlre.

If the executable is not available in your system PATH, set its location with --nm3u8dlre-path or nm3u8dlre_path.

N_m3u8DL-RE also needs FFmpeg. If the FFmpeg executable is not available in your system PATH, set its location with --ffmpeg-path or ffmpeg_path.

Installation

1. Install Gamdl via pip:

   bash复制

   pip install gamdl

2. Set up the cookies file:

   • Place the cookies file in the working directory as cookies.txt, or
   • Specify the path using --cookies-path or in the config file

3. Optional: Set up dependencies (only if you need the functionality) See the Optional Dependencies section to determine which optional tools you need.

Usage

gamdl [OPTIONS] URLS...

Supported URL Types

• Songs (Catalog/Library)
• Albums (Catalog/Library)
• Playlists (Catalog/Library)
• Music Videos (Catalog/Library)
• Artists
• Post Videos
• Apple Music Classical

Examples

Download a song:

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

Download an album:

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

Download from an artist:

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

Interactive Prompt Controls:

⚙️ Configuration

Configure Gamdl using command-line arguments or a config file.

Config file location:

• Linux: ~/.gamdl/config.ini
• Windows: %USERPROFILE%\.gamdl\config.ini

The file is created automatically on first run. Command-line arguments override config values.

Configuration Options