gamdl｜Apple Music 无损下载与 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 下载命令行工具，能把订阅曲目保存为 24bit 无损、4K 音乐视频和同步歌词文件，适合想把曲库离线备份、整理本地媒体库的订阅用户。

它能帮你解决什么

如果你想迁移曲库时按自己选的格式导出文件，或者想把音乐视频按 4K 归档，官方渠道都帮不上忙——Apple Music 网页版不提供"选编码器、选分辨率保存"的能力。gamdl 直接对接 Apple Music 接口，让你按需挑选编码器、分辨率和歌词格式，把内容按规格精确落盘。

从零到第一条命令跑通：Apple Music 无损下载步骤

1. 安装 gamdl（需 Python 3.10+）：

   pip install gamdl

   PyPI 一键装好，不用自己编译。

2. 准备登录态（Cookie）：登录 Apple Music 网页版，用浏览器扩展把 Cookie 以 Netscape 格式导出，保存为工作目录下的cookies.txt（或用--cookies-path指定位置）。Cookie 就是登录态，缺了它无法请求媒体流。

3. 跑通第一条下载命令：

   gamdl "https://music.apple.com/us/album/whenever-you-need-somebody-2022-remaster/1624945511" -o "./Apple Music"

   -o指定输出目录。首次运行会自动生成配置文件（Linux 为~/.gamdl/config.ini，Windows 为%USERPROFILE%\.gamdl\config.ini），之后常用参数可写进配置，命令行参数优先级更高。

三个最值得试的用法：无损、4K 与同步歌词

导出 24bit 无损歌曲

场景：想要接近 CD 品质的存档，而不是默认的 AAC 256kbps Web 码流。

gamdl "https://music.apple.com/us/album/.../1624945511" --song-codec-priority alac --use-wrapper

效果：拿到最高 24-bit/192kHz 的 ALAC 无损文件，元数据与封面自动写入文件。

同步歌词到播放器

场景：想让播放器或播放设备里出现跟读滚动的歌词。

gamdl "https://music.apple.com/us/album/.../1624945511" --synced-lyrics-format srt

效果：同步歌词直接写进文件，srt 时间轴更精确，适合播放器当字幕显示。

切换 4K 音乐视频

场景：音乐视频默认 1080p，你想按 4K 归档。

gamdl "https://music.apple.com/us/artist/.../669771" --music-video-resolution 2160p --music-video-codec-priority h265 --wvd-path ./device.wvd

效果：输出 4K H.265 编码的音乐视频。注意 4K 档要求提供 Widevine L1 的.wvd或 PlayReady SL3K 的.prd设备文件，否则拿不到该分辨率的流。

这些坑我帮你踩过了 🕳️

提示登录相关错误或无订阅？Apple Music 的 Cookie 有有效期，失效后重新从浏览器导出一份cookies.txt即可；改用--use-wrapper后则不再依赖 Cookie。

ALAC 无损下载失败？不带 Wrapper 时 ALAC 大概率因接口限制失败，这不是配置错误——启用 Wrapper v2 服务并加上--use-wrapper再试。

4K 流选不出来？2160p 档位要求 L1 级别的 DRM 设备文件，默认内置 WVD 达不到——用--wvd-path/--prd-path提供.wvd或.prd设备文件，或者接受 1080p。

歌词在播放器里不显示？选ttml是 Apple Music 原生歌词格式，多数播放器不认——把--synced-lyrics-format改成lrc或srt。

写在最后

底层解密与封装由仓库自带的 Rust 扩展完成（核心源码见 gamdl/downloader/），Python 侧负责下载编排与打标签。gamdl 的价值在于：Apple Music 的离线存档从此可以按编码器、分辨率、歌词格式精确保存。目录/文件名模板、封面尺寸等全部配置项见 README.md 的 Configuration 一节，按需查阅即可。

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