gamdl 教程：如何用 3 条命令下载 Apple Music 的 ALAC 无损音乐

gamdl 教程：如何用 3 条命令下载 Apple Music 的 ALAC 无损音乐

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

Apple Music 的普通接口只返回 256kbps 有损音频，ALAC 无损拿不到。gamdl 是一款免费开源的命令行下载工具，把歌曲、专辑或艺术家链接丢给它，它就自动下载音频、解密、打标并落盘。

一句话看懂 gamdl 🎧

gamdl（Glomatico's Apple Music Downloader）是一个开源 CLI（命令行界面）工具：给它链接，它给你文件。查找、下载、解密、打标全程自动完成。能力一览：

• 歌曲：AAC 256kbps（有损）、ALAC 无损最高 24-bit/192kHz、Dolby Atmos、AC-3
• 音乐视频（MV）：最高 2160p（4K），支持 h264 与 h265 编码
• 同步歌词：LRC、SRT、TTML 三种格式（LRC 就是常见的“卡拉OK字幕”格式）
• 元数据：自动写入封面、艺术家、音轨编号等标签，命名模板可自定义
• 支持的链接：歌曲、专辑、播放列表、艺术家、动态视频、Apple Music Classical
• 高度可定制：输出目录、文件夹与文件命名、编码优先级等全部可调

工作原理：你做什么，它做什么 🔍

不用研究源码，理解这条“你 → 它”的分工链就够了：

1. 你导出浏览器 cookies（在已登录 music.apple.com 时导出 Netscape 格式）。它用这份文件确认你的订阅状态，并拿到曲库信息。
2. 你贴一个链接。它识别链接类型、遍历专辑内的曲目，按你设定的编码优先级挑出最优格式。
3. 下载还差一步“解密”。服务器上的文件被 FairPlay（苹果的数字版权保护技术）加密，它先解开，再写成 m4a/mp4 文件并打上元数据标签。
4. ALAC 多一个“中间人”。官方 API 不会向普通请求返回无损流，所以工具支持接入本地 Wrapper 服务（见 gamdl/api/）代你完成账号登录、播放请求和解密；gamdl/downloader/ 里内置的 Rust 组件 ammuxer 负责解密重组和文件写入的快路径。

3 步上手：安装、cookies、首次下载 🚀

第 1 步：安装。需要 Python 3.10 以上，一条命令搞定：

pip install gamdl

第 2 步：准备 cookies 文件。在浏览器登录 Apple Music 的状态下导出 Netscape 格式 cookies（Firefox 可用 “Export Cookies” 扩展，Chromium 用 “Get cookies.txt LOCALLY”），保存为cookies.txt。它是你的“身份证明”，没有它工具无法证明你有订阅。

第 3 步：首次运行，把链接丢给它：

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

--cookies-path用来指定 cookies 文件位置，默认就是当前目录下的./cookies.txt，可省略。跑完后会在输出目录（默认./Apple Music）看到歌曲文件，标签已经打好的。

补充一点：首次运行会自动生成配置文件——Linux 在~/.gamdl/config.ini，Windows 在%USERPROFILE%\.gamdl\config.ini。把长命令写进文件里就能一劳永逸，命令行参数优先级更高，随时可临时覆盖。

进阶用法：ALAC 无损、4K MV 与艺术家整批下载 ⚙️

场景一：下载 ALAC 无损。开启 Wrapper 并设定编码优先级：

gamdl --use-wrapper --song-codec-priority alac,aac-web "链接"

--use-wrapper启用 Wrapper 服务，由它代办登录、播放请求和解密；--song-codec-priority按先后顺序列出偏好的格式，某首曲没有 alac 时自动回落到 aac-web。不开 Wrapper 选 ALAC 时，工具会在启动时警告大概率失败。

场景二：4K 音乐视频。用--music-video-resolution限分辨率，注意 2160p 只有 h265 编码提供：

gamdl --music-video-resolution 2160p --music-video-codec-priority h265,h264 "链接"

场景三：艺术家批量下载。给艺术家链接加上--artist-auto-select，跳过交互式勾选：

gamdl --artist-auto-select all-albums "https://music.apple.com/us/artist/rick-astley/669771"

可选值还有top-songs（热门歌曲）、main-albums（录音室专辑）、music-videos等，完整清单跑gamdl -h即可看到。

gamdl 常见问题解答 ❓

不开 Wrapper 下载 ALAC 会失败吗

大概率会。官方 API 只在“合法播放会话”里下发无损流，Wrapper 替你补上这一步。选alac而没开 Wrapper 时，工具启动即给出警告。

用 Wrapper 还需要 cookies 吗

不需要。Wrapper 模式下登录与播放请求都由它处理，cookies 只在纯 cookie 模式下使用。

aac-web 和 alac 有什么区别

aac-web是 256kbps 有损，日常听够用；alac是无损，最高 24-bit/192kHz，适合对音质有要求的场景。默认值是aac-web。

配置文件在哪、怎么改

Linux 在~/.gamdl/config.ini，Windows 在%USERPROFILE%\.gamdl\config.ini，首次运行自动生成并写好所有默认值。只改你想改的那几行即可，命令里没写的参数都按文件走。

没有订阅能用吗

不能。工具启动时会校验订阅，没有有效订阅会直接报错退出，什么都不下载。

写在最后

gamdl 把你的 Apple Music 链接变成可本地保存的文件，ALAC 无损、4K MV、同步歌词和完整标签一次到位。请只下载你订阅范围内有权使用的内容。参数拿不准时跑一次gamdl -h，所有可选项的帮助文本都在里面。

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