Gamdl + Wrapper 完全指南:3 步搞定 Apple Music 的 ALAC 无损下载

Gamdl + Wrapper 完全指南: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 标着"无损",下载下来却是 AAC?ALAC 流被 API 限制卡住了。Gamdl 加 Wrapper,就是解开这道锁的完整方案。

组合拳:Gamdl 和 Wrapper 各自是谁

Gamdl(Glomatico's Apple Music Downloader)是一个命令行下载器:给它歌曲、专辑或歌手链接,它负责取流、打元数据标签、输出 m4a 文件,一条龙。

Wrapper是本地运行的 wrapper-v2 服务,手里握着一个已登录的 Apple 账户,把公开 API 不干的活全接走:账户鉴权、播放信息请求、加密流解密。说白了,Gamdl 负责干活,Wrapper 是替你对着 Apple 开门的人。这里先解释一个术语:Wrapper 账户,就是登录在 Wrapper 服务器里的那个 Apple ID。

一分钟看懂:Wrapper 如何绕开 Apple Music 的 API 限制

问题出在令牌上。Apple Music 网页端的公开接口只发一张"Web 播放令牌",用它只能换 AAC 网络流。ALAC(Apple Lossless,苹果无损压缩格式)只对走播放接口的认证账户开放,而且流还是加密的,密钥公开接口拿不到。

Wrapper 补的正是这个缺口。--use-wrapper打开后,Gamdl 会向 Wrapper 的/me接口取回账户信息,并从中提取两枚令牌:

media_user_token = auth.get("music_user_token") token = auth.get("dev_token")
  • music_user_token:账户播放凭证,用它发起 ALAC 播放请求;
  • dev_token:开发侧凭证,用来打通对应的 API 通道。

这段逻辑在 gamdl/api/apple_music.py 的create_from_wrapper方法里。令牌到手后,ALAC 请求就走正常通道,解密则由 Wrapper 的 TCP 端口(默认 10020)批量处理,公开接口那道限制就这样被跨过去了。

从零跑通:三步下载 ALAC 无损音乐

第一步:装好 Gamdl

克隆仓库拿最新版,装依赖:

git clone https://gitcode.com/GitHub_Trending/ga/gamdl

前提三样:Python 3.10+、有效的 Apple Music 订阅、以及后面要用的 Wrapper v2 服务器。

第二步:Wrapper 参数配置方法

先让 Wrapper v2 服务器跑起来(默认监听http://127.0.0.1),然后给 Gamdl 传这几个参数(均定义在 gamdl/cli/cli_config.py):

参数默认值作用
--use-wrapper关总开关,开启后账户、播放、解密全走 Wrapper,cookie 可以省
--wrapper-urlhttp://127.0.0.1Wrapper HTTP 地址(账户/播放接口)
--wrapper-decrypt-host127.0.0.1Wrapper 解密服务的 TCP 地址
--wrapper-decrypt-port10020Wrapper 解密服务的 TCP 端口
--song-codec-priorityaac-web编码器优先级,逗号分隔,alac放最前就优先无损

alac是 gamdl/interface/enums.py 里定义的编码器值之一。🔑 首次运行如果 Wrapper 还没登录,终端会提示输入 Apple 账户凭据(开了双重验证的还要填 2FA 码),填完即可。

第三步:执行下载命令并确认 ALAC 文件

带上一首歌或一张专辑的链接开跑:

gamdl --use-wrapper --song-codec-priority=alac <歌曲或专辑链接>

🎧 下载过程中留意日志:编码器选择、下载进度、解密状态都有输出。结束后用播放器或 ffprobe 查一下产出的 m4a,编码器显示 ALAC,才算真正拿到无损。

常见问题与踩坑:ALAC 下载不顺时查这里

⚠️问:指定了 alac,拿到的却是 AAC?

查两处。第一,--song-codec-priority顺序对不对:Gamdl 按顺序逐个尝试,ALAC 取不到就回退到下一个编码器。第二,Wrapper 开没开——不开的话 CLI 会直接提示"没开 Wrapper 的 ALAC 大概率跑不通"。开了 Wrapper 仍回退,多半是该曲目本身没有无损版本,翻日志里的编码器记录即可确认。

问:Wrapper 地址配错会是什么表现?

三种典型报错。连接被拒:--wrapper-url的主机或端口和实际运行的 Wrapper 对不上。提示 "Unsupported wrapper-v2 API version":Wrapper 版本和 Gamdl 要求不匹配,当前要求 wrapper-v2 API 0.0.2。提示 "Wrapper is not authenticated":服务器里的账户根本没登录。对照报错逐个修就行。

问:开了 Wrapper 还要导出 cookies 吗?

不用。Wrapper 模式下 cookie 可以直接跳过,这正是集成的省事之处之一。🔁 想两种模式都用,就把 cookies.txt 放在工作目录,仅在不开 Wrapper 时提供它。

第一个无损 m4a 落进曲库的那一刻,你会觉得折腾是值得的。Wrapper 生态还在快速迭代,遇到新坑多翻翻 gamdl 与 wrapper-v2 的更新记录。

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

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

相关新闻

CVE-2024-1086本地提权漏洞:触发机制与修复清单

CVE-2024-1086本地提权漏洞:触发机制与修复清单

CVE-2024-1086本地提权漏洞&#xff1a;触发机制与修复清单 【免费下载链接】CVE-2024-1086 Universal local privilege escalation Proof-of-Concept exploit for CVE-2024-1086, working on most Linux kernels between v5.14 and v6.6, including Debian, Ubuntu, and Kerne…

2026/11/18 20:08:06 阅读更多 →
Android 14文件管理革命:awesome-shizuku如何突破系统限制 [特殊字符]

Android 14文件管理革命:awesome-shizuku如何突破系统限制 [特殊字符]

Android 14文件管理革命&#xff1a;awesome-shizuku如何突破系统限制 &#x1f680; 在 Android 14 系统中&#xff0c;Google 进一步加强了文件访问权限管理&#xff0c;特别是对 /Android/data 和 /Android/obb 目录的访问限制&#xff0c;这让许多用户感到困扰。&#x1f…

2026/11/17 23:33:28 阅读更多 →
部署HyLo-Llama-14MLA14GDN-64K-SFT避坑指南:max_position_embeddings陷阱与研究许可须知

部署HyLo-Llama-14MLA14GDN-64K-SFT避坑指南:max_position_embeddings陷阱与研究许可须知

【免费下载链接】HyLo-Llama-14MLA14GDN-64K-SFT 项目地址&#xff1a; https://ai.gitcode.com/hf_mirrors/amd/HyLo-Llama-14MLA14GDN-64K-SFT 点击查看 免费下载 HyLo-Llama-14MLA14GDN-64K-SFT 是 AMD 发布的混合架构长文本大模型&#xff1a;14 层 MLA 14 层 Gated Delt…

2026/11/17 19:32:07 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年&#xff0c;我大部分时间都在跟浏览器标签页打交道&#xff0c;直到第一次把桌面应用跑起来&#xff0c;才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词&#xff0c;最开始是在某段时间频繁出现在同事的讨论里&#xff0c;一个用HTML…

2026/11/18 13:59:04 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介&#xff1a;亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档&#xff0c;主要面向智能锁安装人员、终端用户及售后维护者&#xff0c;帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件&#xff0c;大小4.37MB&#xff0c;内容结构清晰&#xff…

2026/11/18 15:33:23 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统&#xff0c;整车要求空载跑到8m/s&#xff0c;电机转速已经拉到额定点&#xff0c;驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令&#xff0c;转速纹丝不动&#xff0c;三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/18 17:05:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年&#xff0c;用它写过嵌入式驱动、做过游戏服务端&#xff0c;也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词&#xff0c;我其实挺感慨的——这门语言的难点从来不是语法多&#xff0c;而是知识点之间的耦合太深…

2026/11/18 14:33:19 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介&#xff1a;亚太天能T109滑盖智能锁产品说明书以PDF格式发布&#xff0c;适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开&#xff0c;先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能&#xff0c;再给出完整安装步骤&…

2026/11/18 17:05:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历&#xff1a;翻开源码注释、论文摘要或者一份专业报告&#xff0c;每个字都认识&#xff0c;连在一起却像天书。想找人聊聊&#xff0c;身边要么没人懂&#xff0c;要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型&#xff0c;几秒钟之后&a…

2026/11/18 14:13:08 阅读更多 →

日新闻

周新闻

月新闻