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 无损下载步骤
安装 gamdl（需 Python 3.10+）：
pip install gamdlPyPI 一键装好，不用自己编译。
准备登录态（Cookie）：登录 Apple Music 网页版，用浏览器扩展把 Cookie 以 Netscape 格式导出，保存为工作目录下的
cookies.txt（或用--cookies-path指定位置）。Cookie 就是登录态，缺了它无法请求媒体流。跑通第一条下载命令：
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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
