Gamdl：用命令行下载 Apple Music 的全部内容

Gamdl：用命令行下载 Apple Music 的全部内容

gamdl 在 GitHub 上拿到了 2,392 Star。

这是一个 Python 写的命令行工具，专门从 Apple Music 下载歌曲、MV 和 Post 视频。下载质量这块，歌曲支持 AAC 256kbps、Dolby Atmos、ALAC 无损等多种编码，MV 最高能到 4K 分辨率。歌词也能同步下载，LRC、SRT、TTML 三种格式任选。

为什么需要这个工具

Apple Music 的客户端本身不提供下载导出功能，哪怕你是付费订阅用户，音乐也只能在 App 内播放。对于想把音乐文件存到本地、导入其他播放器、或者做音乐库备份的人来说，一直缺少一个靠谱的命令行方案。

gamdl 解决的就是这个问题。给它一个 Apple Music 的链接，它直接从苹果服务器拉取音频或视频文件，自动写入歌曲名、艺术家、专辑、封面等元数据标签，下载完就能用。

支持哪些内容

支持的链接类型覆盖面很广：单曲、专辑、播放列表、MV、艺人页面、Post 视频，甚至 Apple Music Classical 也支持。不管是目录页还是个人资料库里收藏的内容，都能处理。

批量下载也方便，艺人页面链接丢进去，可以选择下载该艺人的全部专辑、精选辑、现场版、单曲 EP、热门歌曲或 MV，不需要一个个手动挑。

音频编码选择

Web 编码直接可用，不需要额外配置：aac-web（AAC 256kbps）、aac-he-web（AAC-HE 64kbps）。

如果想用更高质量的编码，比如 Atmos 768kbps、AC3 640kbps、ALAC 无损，需要配合 Wrapper 服务使用。Wrapper 是同一个作者开发的辅助服务，负责处理账号认证、播放请求和解密。启动 Wrapper 后，gamdl 通过--use-wrapper参数开启即可。

另外还支持双耳渲染（binaural）和降混（downmix）版本，对耳机用户有实际意义。

安装和基本用法

安装就一行命令：

pip install gamdl

使用前需要准备 Apple Music 的 Cookies 文件。在浏览器登录 Apple Music 网页版，用插件导出 Netscape 格式的 cookies.txt，放到工作目录下。Firefox 用 Export Cookies 插件，Chrome 用 Get cookies.txt LOCALLY。

下载歌曲：

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"

交互界面用方向键移动、空格切换选中、Ctrl+A 全选、回车确认，操作逻辑很直观。

配置灵活度

gamdl 的配置项相当多。可以通过命令行参数传入，也可以写配置文件（Linux 在 ~/.gamdl/config.ini，Windows 在 %USERPROFILE%.gamdl\config.ini），首次运行自动生成。

几个实用的配置：

输出路径默认是当前目录下的 Apple Music 文件夹，可以用-o改。文件命名支持模板变量，比如{album_artist}/{album}作为专辑文件夹、{track:02d} {title}作为单曲文件名，专辑日期、碟片编号、播放列表名称都能作为模板字段。

下载模式默认用 yt-dlp，也可以切换到 N_m3u8DL-RE，后者速度更快，但需要额外安装 FFmpeg。

封面图格式支持 JPG、PNG 和原始格式，尺寸默认 1200 像素，都可以调整。

适合谁用

想把 Apple Music 曲库备份到本地的人。订阅到期后下载的文件还在，不依赖任何流媒体服务。

做 DJ 或音乐编辑的人，需要原始音频文件而不是流媒体缓存。

想在非苹果设备上播放 Apple Music 内容的用户，下载后同步到任意播放器即可。

有编程需求的开发者，gamdl 可以作为 Python 库嵌入项目，通过异步接口批量处理下载任务。

e Music 内容的用户，下载后同步到任意播放器即可。

有编程需求的开发者，gamdl 可以作为 Python 库嵌入项目，通过异步接口批量处理下载任务。