Gamdl 下载 Apple Music 教程ALAC 无损、批量下载与报错排查【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdlGamdl 是下载 Apple Music 的命令行工具支持歌曲、专辑、播放列表与音乐视频音质可选至 ALAC 无损。本文讲解安装、Cookie 导出、Wrapper 接入与报错排查带你完成首次无损下载。Gamdl 能下载什么内容类型与三项前置准备gamdlGlomaticos Apple Music Downloader是一个 Python 命令行工具用来下载 Apple Music 内容并把歌名、歌手、专辑、封面等元数据自动写入文件。直接把对应链接传给命令即可下载支持的内容包括歌曲、专辑、播放列表商店与个人资料库均可音乐视频最高 4K与 post 视频艺人页面可一次性选取其全部专辑或音乐视频Apple Music Classical开始之前请确认三项前置条件Python 3.10 或更高版本处于有效期的 Apple Music 订阅Apple Music 的浏览器 Cookie或改用 Wrapper 登录下文会讲它适合想把订阅曲库存档到本地、需要无损音质或要批量整理文件的新手和进阶用户。 三分钟上手安装 Gamdl 并下载第一首歌先安装工具本体一条命令完成pip install gamdl然后准备 Cookie在浏览器登录 music.apple.com用 Cookie 导出类扩展以 Netscape 格式导出保存为 cookies.txt。放在工作目录即可被自动识别放在别处时用 --cookies-path 指定路径。准备好后传入一个歌曲链接即可下载gamdl https://music.apple.com/专辑页?i歌曲ID文件默认写入 ./Apple Music 目录可用 --output-path 换成你习惯的位置。两个容易遇到的细节传入艺人页面时会进入交互选择界面方向键移动空格切换选中CtrlA 全选回车确认。首次运行会自动生成配置文件Linux 位于 ~/.gamdl/config.iniWindows 位于 %USERPROFILE%.gamdl\config.ini把常改的项写进去即可省去重复敲参数且命令行参数始终优先于配置文件。如何配置 Wrapper 下载 ALAC 无损音乐默认情况下 gamdl 下载 aac-webAAC 256kbps。想要无损就选 ALAC最高 24-bit/192kHz但 ALAC 流需要经过 Wrapper 通道直接裸取大概率会因 API 限制失败gamdl 也会给出警告。Wrapperwrapper-v2是一个本地中转服务负责账户登录、播放请求和解密登录后你就不再需要提供 Cookie。先在自己的机器上部署好 wrapper-v2再给下载命令加上开关gamdl --use-wrapper --song-codec-priority alac 链接参数说明--use-wrapper账户、播放与解密请求改由 Wrapper 处理--song-codec-priority alac把编码优先级设为 ALAC默认值是 aac-webWrapper HTTP 服务默认地址为 http://127.0.0.1TCP 解密端口默认 10020部署不同时用 --wrapper-url 与 --wrapper-decrypt-port 指定。首次使用会提示输入 Apple ID 密码支持双因素验证登录后凭据会被 Wrapper 复用。如果担心个别内容没有 ALAC 版本可以写降级顺序--song-codec-priority alac,aac-web。批量下载整位艺术家、播放列表与 URL 文件批量下载本质上是传更大的链接或传一个装链接的文件三种方式艺人页面传入艺人链接即可配合 --artist-auto-select 可跳过交互选择取值包括 main-albums主要专辑、all-albums全部专辑、top-songs热门歌曲、music-videos音乐视频等。播放列表直接传播放列表链接文件按播放列表文件夹模板归类默认 Playlists/{playlist_artist}。URL 清单把多个链接存进一个文本文件每行一个然后执行gamdl --read-urls-as-txt urls.txt这种方式适合先整理好清单再一次性执行的场景执行时会按 URL 顺序显示进度单个失败不影响后续条目。 整理曲库元数据模板怎么改默认情况下专辑存放在 {album_artist}/{album} 目录中文件名为 {track:02d} {title}例如01 歌曲名。模板是带变量占位符的字符串你可以按自己的习惯重组目录结构。常用变量album、album_artist、artist、title、track、disc、date支持 strftime 写法如 {date:%Y}、playlist_title、playlist_artist。例如按艺人/年份/专辑归档gamdl --album-folder-template {album_artist}/{date:%Y}/{album} 专辑链接几个值得知道的整理参数--language元数据语言使用 ISO 639-1 代码默认 en-US--exclude-tags不写入指定标签例如 --exclude-tags comment,rating写 all 则完全跳过打标签--truncate限制文件名最大长度已存在的文件默认跳过加 --overwrite 才会覆盖。下载模式选择ytdlp 与 N_m3u8DL-RE默认下载模式是 ytdlp。注意 yt-dlp 在这里只充当下载库媒体流仍然直接来自 Apple Music 的服务器。如果下载文件量大、希望换更快的 HLS 下载器 N_m3u8DL-REgamdl --download-mode nm3u8dlre 链接该模式需要额外准备两个依赖N_m3u8DL-RE 可执行文件和 FFmpeg。若它们不在系统 PATH 中用 --nm3u8dlre-path 和 --ffmpeg-path 指定路径。不需要更快时保持默认模式即可不必安装额外工具。 常见报错处理遇到这些提示怎么办提示 No active Apple Music subscription found说明没有检测到有效订阅此时任何内容都无法下载。先确认订阅仍在有效期内。警告 You have chosen ALAC without enabling wrapper选了 ALAC 却没启用 Wrapper。要么加上 --use-wrapper要么把优先级改回 aac-web 或 aac。部分内容被跳过格式不可用 / 无法流式播放当前账户或商店可能没有对应的音质版本可尝试调整 --song-codec-priority或重新导出一份新的 Cookie。文件已存在被跳过这是防止覆盖的默认行为。想重新下载时加 --overwrite想避免重复下载可用 --database-path 维护一个 SQLite 记录库。Wrapper 连接失败按顺序排查确认 wrapper-v2 服务正在运行 → 核对 --wrapper-url 地址与解密端口--wrapper-decrypt-port默认 10020是否和服务一致 → 确认 Wrapper 版本与当前 gamdl 兼容要求 wrapper-v2 API 0.0.2。以上都解决不了时打开调试日志查看完整流程gamdl --log-level DEBUG --log-file gamdl.log 链接使用限制与注意事项全程依赖有效订阅Cookie 会随时间失效遇到认证类报错优先重新导出。账户开启内容限制时gamdl 会提示部分内容可能无法下载。4K 音乐视频2160p仅限 H.265且需要 Widevine L1.wvd或 PlayReady SL3K.prd设备文件分别通过 --wvd-path 或 --prd-path 提供。Wrapper 请部署在自己的机器与网络上不要把 Apple ID 凭据交给不明第三方服务。下载的内容建议仅用于个人欣赏。项目采用 MIT 协议使用问题可去官方 Discord 讨论或提交 issue目前仅接受关键缺陷修复。【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdl创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Gamdl 下载 Apple Music 教程：ALAC 无损、批量下载与报错排查
Gamdl 下载 Apple Music 教程ALAC 无损、批量下载与报错排查【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdlGamdl 是下载 Apple Music 的命令行工具支持歌曲、专辑、播放列表与音乐视频音质可选至 ALAC 无损。本文讲解安装、Cookie 导出、Wrapper 接入与报错排查带你完成首次无损下载。Gamdl 能下载什么内容类型与三项前置准备gamdlGlomaticos Apple Music Downloader是一个 Python 命令行工具用来下载 Apple Music 内容并把歌名、歌手、专辑、封面等元数据自动写入文件。直接把对应链接传给命令即可下载支持的内容包括歌曲、专辑、播放列表商店与个人资料库均可音乐视频最高 4K与 post 视频艺人页面可一次性选取其全部专辑或音乐视频Apple Music Classical开始之前请确认三项前置条件Python 3.10 或更高版本处于有效期的 Apple Music 订阅Apple Music 的浏览器 Cookie或改用 Wrapper 登录下文会讲它适合想把订阅曲库存档到本地、需要无损音质或要批量整理文件的新手和进阶用户。 三分钟上手安装 Gamdl 并下载第一首歌先安装工具本体一条命令完成pip install gamdl然后准备 Cookie在浏览器登录 music.apple.com用 Cookie 导出类扩展以 Netscape 格式导出保存为 cookies.txt。放在工作目录即可被自动识别放在别处时用 --cookies-path 指定路径。准备好后传入一个歌曲链接即可下载gamdl https://music.apple.com/专辑页?i歌曲ID文件默认写入 ./Apple Music 目录可用 --output-path 换成你习惯的位置。两个容易遇到的细节传入艺人页面时会进入交互选择界面方向键移动空格切换选中CtrlA 全选回车确认。首次运行会自动生成配置文件Linux 位于 ~/.gamdl/config.iniWindows 位于 %USERPROFILE%.gamdl\config.ini把常改的项写进去即可省去重复敲参数且命令行参数始终优先于配置文件。如何配置 Wrapper 下载 ALAC 无损音乐默认情况下 gamdl 下载 aac-webAAC 256kbps。想要无损就选 ALAC最高 24-bit/192kHz但 ALAC 流需要经过 Wrapper 通道直接裸取大概率会因 API 限制失败gamdl 也会给出警告。Wrapperwrapper-v2是一个本地中转服务负责账户登录、播放请求和解密登录后你就不再需要提供 Cookie。先在自己的机器上部署好 wrapper-v2再给下载命令加上开关gamdl --use-wrapper --song-codec-priority alac 链接参数说明--use-wrapper账户、播放与解密请求改由 Wrapper 处理--song-codec-priority alac把编码优先级设为 ALAC默认值是 aac-webWrapper HTTP 服务默认地址为 http://127.0.0.1TCP 解密端口默认 10020部署不同时用 --wrapper-url 与 --wrapper-decrypt-port 指定。首次使用会提示输入 Apple ID 密码支持双因素验证登录后凭据会被 Wrapper 复用。如果担心个别内容没有 ALAC 版本可以写降级顺序--song-codec-priority alac,aac-web。批量下载整位艺术家、播放列表与 URL 文件批量下载本质上是传更大的链接或传一个装链接的文件三种方式艺人页面传入艺人链接即可配合 --artist-auto-select 可跳过交互选择取值包括 main-albums主要专辑、all-albums全部专辑、top-songs热门歌曲、music-videos音乐视频等。播放列表直接传播放列表链接文件按播放列表文件夹模板归类默认 Playlists/{playlist_artist}。URL 清单把多个链接存进一个文本文件每行一个然后执行gamdl --read-urls-as-txt urls.txt这种方式适合先整理好清单再一次性执行的场景执行时会按 URL 顺序显示进度单个失败不影响后续条目。 整理曲库元数据模板怎么改默认情况下专辑存放在 {album_artist}/{album} 目录中文件名为 {track:02d} {title}例如01 歌曲名。模板是带变量占位符的字符串你可以按自己的习惯重组目录结构。常用变量album、album_artist、artist、title、track、disc、date支持 strftime 写法如 {date:%Y}、playlist_title、playlist_artist。例如按艺人/年份/专辑归档gamdl --album-folder-template {album_artist}/{date:%Y}/{album} 专辑链接几个值得知道的整理参数--language元数据语言使用 ISO 639-1 代码默认 en-US--exclude-tags不写入指定标签例如 --exclude-tags comment,rating写 all 则完全跳过打标签--truncate限制文件名最大长度已存在的文件默认跳过加 --overwrite 才会覆盖。下载模式选择ytdlp 与 N_m3u8DL-RE默认下载模式是 ytdlp。注意 yt-dlp 在这里只充当下载库媒体流仍然直接来自 Apple Music 的服务器。如果下载文件量大、希望换更快的 HLS 下载器 N_m3u8DL-REgamdl --download-mode nm3u8dlre 链接该模式需要额外准备两个依赖N_m3u8DL-RE 可执行文件和 FFmpeg。若它们不在系统 PATH 中用 --nm3u8dlre-path 和 --ffmpeg-path 指定路径。不需要更快时保持默认模式即可不必安装额外工具。 常见报错处理遇到这些提示怎么办提示 No active Apple Music subscription found说明没有检测到有效订阅此时任何内容都无法下载。先确认订阅仍在有效期内。警告 You have chosen ALAC without enabling wrapper选了 ALAC 却没启用 Wrapper。要么加上 --use-wrapper要么把优先级改回 aac-web 或 aac。部分内容被跳过格式不可用 / 无法流式播放当前账户或商店可能没有对应的音质版本可尝试调整 --song-codec-priority或重新导出一份新的 Cookie。文件已存在被跳过这是防止覆盖的默认行为。想重新下载时加 --overwrite想避免重复下载可用 --database-path 维护一个 SQLite 记录库。Wrapper 连接失败按顺序排查确认 wrapper-v2 服务正在运行 → 核对 --wrapper-url 地址与解密端口--wrapper-decrypt-port默认 10020是否和服务一致 → 确认 Wrapper 版本与当前 gamdl 兼容要求 wrapper-v2 API 0.0.2。以上都解决不了时打开调试日志查看完整流程gamdl --log-level DEBUG --log-file gamdl.log 链接使用限制与注意事项全程依赖有效订阅Cookie 会随时间失效遇到认证类报错优先重新导出。账户开启内容限制时gamdl 会提示部分内容可能无法下载。4K 音乐视频2160p仅限 H.265且需要 Widevine L1.wvd或 PlayReady SL3K.prd设备文件分别通过 --wvd-path 或 --prd-path 提供。Wrapper 请部署在自己的机器与网络上不要把 Apple ID 凭据交给不明第三方服务。下载的内容建议仅用于个人欣赏。项目采用 MIT 协议使用问题可去官方 Discord 讨论或提交 issue目前仅接受关键缺陷修复。【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdl创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考