企业官网建设流程全解析

Apple Music 下载工具 gamdl 实战指南：无损歌曲与 4K 音乐视频一条命令搞定

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

gamdl 是一款开源的 Apple Music 下载工具，能把订阅曲库里的歌曲、专辑、音乐视频按高质量保存到本地，并自动附带上歌词和元数据。适合想离线听歌或收藏 4K 音乐视频的用户，下面讲讲它的完整用法。

💡 为什么需要它

苹果订阅的歌曲在 App 里只能在线播放，一旦退订、设备更换或长时间断网，曲库就等于"消失"了。gamdl 把这些内容变成真正属于你的本地文件。

它还适合想收藏音乐视频的用户——很多 MV 在流媒体端只有有限清晰度，而 gamdl 能按你选择的分辨率保存，最高支持 2160p（4K）。

对于想批量整理曲库的人来说，它更省事：粘贴一张专辑、歌单甚至艺人主页的链接，整批内容会自动按"艺人/专辑"的文件夹结构下载好，不用一首首手动点。

🚀 从零跑通：四步下出第一个文件

第一步，准备环境：需要 Python 3.10 及以上版本，并且有一个处于有效期的 Apple Music 订阅。

第二步，安装工具：

pip install gamdl

第三步，导出浏览器 Cookie。在已登录 music.apple.com 的状态下，用浏览器的 Cookie 导出插件（Firefox 可选 Export Cookies，Chromium 可选 Get cookies.txt LOCALLY）导出为 Netscape 格式，保存为cookies.txt。

第四步，把歌曲或专辑页面链接粘贴到命令行，并指定输出目录：

gamdl "https://music.apple.com/album/…" -o "./Apple Music"

回车后就会开始下载，文件默认按{album_artist}/{album}的结构自动归档。

⚙️ 关键能力详解

音质档位怎么选：从 256kbps 到 24-bit 无损

默认下载aac-web（AAC 256kbps），日常听感已经够用。追求更高音质时，用--song-codec-priority指定编码，可选项包括alac（无损，最高 24-bit/192kHz）、atmos（杜比全景声 768kbps）和ac3等。其中alac建议配合 Wrapper v2 使用，否则大概率会因 API 限制失败。

音乐视频分辨率：默认 1080p，4K 也可以

用--music-video-resolution控制清晰度上限，默认 1080p。注意1440p和2160p只有 H.265 编码提供，而下载 4K 源需要 Widevine L1 的.wvd设备文件或 PlayReady SL3K 的.prd设备文件，通过--wvd-path/--prd-path指定。没有设备文件时，1080p 以内是最稳的选择。

歌词格式：三种可选，别选错

--synced-lyrics-format支持lrc（默认）、srt（时间轴更精确）和ttml（Apple Music 原生格式）。ttml对大多数播放器不兼容，除非你明确需要原生格式，否则选前两者更省心。歌曲下载时还会自动写入完整的专辑、艺人等元数据，无需二次打标。

🛠️ 三条容易踩的坑

1. Cookie 是最常见的卡点：文件必须放在工作目录并命名为cookies.txt，或用--cookies-path显式指定；导出时务必保持登录且有有效订阅的状态，否则下载中途会报鉴权错误。
2. 输出路径别留空想：默认写入当前目录下的./Apple Music，建议先用-o指定一个独立目录；已下载的文件默认不会覆盖，重复执行是安全的。
3. 参数写进配置文件更省事：首次运行会在~/.gamdl/config.ini自动生成配置，把常用的输出路径、音质、清晰度填进去后，之后只敲gamdl "URL"就够了，命令行参数优先级高于配置。

更多选项和模板变量说明，可以看仓库里的 README.md，音频与媒体的处理逻辑集中在 gamdl/downloader/ 目录。

✍️ 写在最后

gamdl 把"订阅内容转本地文件"这件事压缩成了一条命令，音质、清晰度、归档结构都能按自己的习惯调。现在就可以打开终端，从 Apple Music 网站复制一个你常听的专辑链接，跑一下那条第一个命令。

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