gamdl 实操指南：Apple Music 无损音频与 4K 音乐视频离线导出

发布时间：2026/11/4 6:25:48
gamdl 实操指南：Apple Music 无损音频与 4K 音乐视频离线导出

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

Apple Music 上的内容无法直接带走离线播放，想自建本地曲库又控制不了码率和分辨率。gamdl 是一款命令行导出工具，让你按编码器、分辨率、歌词格式自选规格，拿到 ALAC 无损文件和最高 4K 的音乐视频。适合有有效订阅、需要整理本地媒体库的用户。

gamdl 是什么，适合谁

gamdl 直接请求 Apple Music 接口，负责把歌曲、音乐视频和 Post 视频三类内容导出成文件。

你的场景它给你什么
换设备或迁移曲库，想让订阅歌曲离线留存ALAC 无损（最高 24-bit/192kHz）或 AAC 256kbps 文件，自动写入元数据与封面
需要高清音乐视频存档分辨率最高 4K，H.264 / H.265 可选
想要同步歌词随文件保存LRC、SRT、TTML 三种格式任选
想批量处理某位歌手传入艺术家主页链接，交互式勾选专辑或音乐视频

gamdl 安装与 Cookie 登录态准备

按顺序备齐以下四项，装完即可开跑：

pip install gamdl
  • Python 3.10+：gamdl 要求的最低运行版本，用python --version确认。
  • 有效的 Apple Music 订阅：gamdl 启动时会校验订阅状态，无订阅直接拒绝运行。
  • cookies.txt登录态：这是请求媒体流的凭据。登录 Apple Music 网页后，用浏览器扩展把 Cookie 按 Netscape 格式导出为cookies.txt，放在工作目录，或用--cookies-path指定路径。
  • 设备文件（可选）：4K 音乐视频需要 Widevine L1 的.wvd或 PlayReady SL3K 的.prd文件；ALAC 建议搭配 Wrapper v2 服务使用。

首次运行：导出一个完整专辑

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

文件按“艺术家/专辑”结构保存在./Apple Music下，元数据与封面自动写入。首次运行会在~/.gamdl/config.ini（Windows 为%USERPROFILE%\.gamdl\config.ini）自动生成配置文件，常用参数可写进去，命令行参数优先于配置。

⚙️ 能力深挖

4K 音乐视频导出，把画质拉满

音乐视频默认只给 1080p，要拿到 4K 需要凑齐分辨率参数和安全级设备文件两样东西。

关键参数：--music-video-resolution设为2160p；该档位仅 H.265 支持，需同时写--music-video-codec-priority h265；再用--wvd-path提供 Widevine L1 设备文件，或改用--drm-backend playready并提供--prd-path。

gamdl "<音乐视频链接>" --music-video-resolution 2160p --music-video-codec-priority h265 --wvd-path ./device.wvd

效果：可导出 2160p H.265 视频，容器默认 m4v，--music-video-remux-format mp4可换成 mp4。限制：拿不到高安全级设备文件时，服务端不会下发 4K 流，上限停在 1080p。

ALAC 无损切换，一命令拿到最高规格音频

歌曲默认走 AAC 256kbps 的 Web 流，只有把优先级改成alac才能拿到无损文件。

关键参数：--song-codec-priority alac；ALAC 流受 API 限制，建议同时启用--use-wrapper对接 Wrapper v2 服务——它接管账号、播放和解密请求，启用后还可以跳过 Cookie。

命令：gamdl "<专辑链接>" --song-codec-priority alac --use-wrapper

效果：得到最高 24-bit/192kHz 的完整无损文件。限制：未启用 Wrapper 就选 ALAC 时，CLI 会主动给出警告，下载大概率失败，这是接口限制而不是参数配错。

同步歌词与元数据写入

下载结束后，艺术家、专辑、封面等元数据会自动写进文件，同步歌词一并附带。

关键参数：--synced-lyrics-format在lrc/srt/ttml中选择；--language设定元数据语言（ISO 639-1 编码，如en-US）；--cover-size控制封面像素，默认 1200。

命令：gamdl "<歌曲链接>" --synced-lyrics-format srt

效果：srt 的时间轴最精确，适合喂给播放器当字幕。限制：ttml 是 Apple Music 原生格式，多数播放器不认，要在播放界面显示歌词就选 lrc 或 srt。

🩺 常见问题自查表

现象原因处理
启动即报登录相关错误、订阅校验不通过cookies.txt已过期，Apple Music 的 Cookie 有有效期重新从浏览器导出一份 Netscape 格式 Cookie；或启用--use-wrapper后不再依赖 Cookie
选了 ALAC 有警告且下载失败ALAC 流受接口限制，缺少 Wrapper 支撑部署并启动 Wrapper v2 服务，加--use-wrapper重试
设置 2160p 却只得到 1080p 文件没有 Widevine L1.wvd或 PlayReady SL3K.prd设备文件提供--wvd-path；或换--drm-backend playready并提供--prd-path

深入阅读

  • 完整参数表、模板变量、编码器与分辨率清单：README.md 的 Configuration 一节。
  • 解密与封装引擎：gamdl/downloader/ammuxer/，内置 Rust 扩展，核心逻辑见 src/decrypt.rs。
  • 全部命令行参数源码定义：gamdl/cli/cli_config.py。
  • Wrapper 服务对接逻辑：gamdl/api/wrapper.py。

收尾

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考