当前位置：首页 > news >正文

3分钟学会Gamdl：命令行下载Apple Music无损音乐和高清MV的终极指南

news 2026/8/10 19:22:56

3分钟学会Gamdl：命令行下载Apple Music无损音乐和高清MV的终极指南

【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdl

Gamdl是一款强大的命令行工具，专门用于从Apple Music平台下载无损音乐和高清音乐视频。无论你是音乐爱好者还是视频收藏家，这个开源项目都能让你轻松保存高品质的音频和视频内容。本文将为你提供一个快速入门指南，让你在短短3分钟内掌握使用Gamdl下载Apple Music无损音乐和高清MV的核心技巧。

🎯 Gamdl是什么？为什么选择它？

Gamdl（Glomatico's Apple Music Downloader）是一个专业的Python命令行应用程序，能够直接从Apple Music服务器获取高品质的音乐和视频文件。与传统的下载方式不同，Gamdl支持多种音频编解码器，包括高品质的ALAC无损格式，让你能够享受真正的无损音乐体验。

✨ 核心功能亮点

🎵 高品质音频下载- 支持AAC 256kbps、ALAC无损等多种音频格式
🎬 4K高清MV下载- 最高支持2160p分辨率的高清音乐视频
📝 同步歌词支持- 可下载LRC、SRT等多种格式的同步歌词
🏷️ 完整元数据- 自动添加专辑封面、艺术家信息等完整标签
⚙️ 高度可定制- 丰富的配置选项满足不同用户需求

🚀 快速安装指南

系统要求

Python 3.10或更高版本
有效的Apple Music订阅
Netscape格式的Cookies文件（从浏览器导出）

安装步骤

通过pip安装Gamdl：

pip install gamdl

准备Cookies文件：
- 在浏览器中登录Apple Music网页版
- 使用浏览器扩展导出Netscape格式的cookies文件
- 将文件保存为cookies.txt或指定路径
可选依赖安装：
- 如果需要ALAC无损格式支持，建议安装Wrapper v2
- 如需更快的下载速度，可安装N_m3u8DL-RE

📋 基础配置设置

Gamdl的配置非常灵活，可以通过命令行参数或配置文件进行设置。配置文件位于：

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

常用配置选项

配置项	描述	默认值
输出路径	下载文件的保存位置	`./Apple Music`
音频质量	音频编解码器优先级	`aac-web`
视频分辨率	MV最高分辨率	`1080p`
下载模式	下载引擎选择	`ytdlp`

配置文件会在首次运行时自动创建，命令行参数会覆盖配置文件中的设置。

🎵 开始你的无损音乐下载之旅

下载单首歌曲

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 "https://music.apple.com/us/playlist/your-playlist/pl.xxxxxxxxxxxx"

⚙️ 高级功能详解

批量下载技巧

如果你有多个URL需要下载，可以创建一个文本文件，每行一个URL，然后使用：

gamdl --read-urls-as-txt urls.txt

自定义文件命名

Gamdl支持强大的模板系统，让你可以自定义文件和文件夹的命名格式：

专辑文件夹模板:{album_artist}/{album}
单曲文件模板:{track:02d} {title}
多碟专辑模板:{disc}-{track:02d} {title}

音频格式选择

支持多种音频编解码器，按优先级选择：

网页格式:AAC 256kbps 44.1kHz
非网页格式:AAC 256kbps 最高48kHz
无损格式:ALAC 最高24-bit/192kHz

视频下载选项

分辨率选择:240p到2160p（4K）
编解码器:H.264或H.265
容器格式:M4V或MP4

🔧 项目架构概览

Gamdl采用模块化设计，主要包含以下几个核心模块：

核心下载器模块

gamdl/downloader/ - 下载器核心逻辑
gamdl/downloader/song.py - 歌曲下载实现
gamdl/downloader/music_video.py - 音乐视频下载实现

API接口层

gamdl/api/ - Apple Music API封装
gamdl/api/apple_music.py - 主要API接口

命令行界面

gamdl/cli/ - 命令行界面实现
gamdl/cli/cli.py - 主命令行入口

界面交互层

gamdl/interface/ - 用户界面抽象
gamdl/interface/base.py - 基础接口类

💡 实用技巧与最佳实践

1. 使用Wrapper提升体验

对于ALAC无损格式下载，建议使用Wrapper v2，它能提供更好的账户管理和解密功能：

gamdl --use-wrapper "https://music.apple.com/..."

2. 优化下载速度

使用N_m3u8DL-RE作为下载引擎可以显著提升下载速度：

gamdl --download-mode nm3u8dlre "https://music.apple.com/..."

3. 元数据语言设置

根据需要设置元数据语言，支持多种语言代码：

gamdl --language ja-JP "https://music.apple.com/..."

4. 交互式选择

当遇到需要选择的场景时，Gamdl会提供交互式界面：

方向键- 移动选择
空格键- 切换选择
Ctrl + A- 全选
回车键- 确认选择

🐛 常见问题解决

登录问题

确保你的cookies文件有效且未过期。如果使用Wrapper模式，需要正确配置Wrapper服务器地址。

下载失败

检查网络连接，查看日志文件了解具体错误信息：

gamdl --log-file download.log "https://music.apple.com/..."

格式转换问题

Gamdl支持多种音频和视频格式转换，可在配置中设置remux_mode和codec选项。

🚀 进阶使用：Python库集成

Gamdl也可以作为Python库在项目中集成使用：

import asyncio from gamdl.api import AppleMusicApi from gamdl.downloader import AppleMusicDownloader async def download_music(): # 创建API实例 api = await AppleMusicApi.create_from_netscape_cookies("cookies.txt") # 创建下载器 downloader = AppleMusicDownloader.from_api(api) # 下载音乐 url = "https://music.apple.com/..." await downloader.download_from_url(url) if __name__ == "__main__": asyncio.run(download_music())