☰
gamdl 教程:如何用 3 条命令下载 Apple Music 的 ALAC 无损音乐
2026/10/21 1:44:23 网站建设 项目流程

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询