Gamdl 教程3 步把 Apple Music 歌曲与音乐视频下载到本地【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdl你肯定遇到过这种情况Apple Music 里看到一首想长期收藏的歌、一支想反复看的高清 MV但订阅一旦中断这些内容就全没了。官方离线模式又无法让你把它们放进自己的音乐库统一管理。GamdlGlomaticos Apple Music Downloader是一个开源命令行工具专门用来下载 Apple Music 的歌曲、音乐视频和发布视频。在浏览器里把歌曲链接复制出来在终端执行一条gamdl命令本地目录里就会多出带完整元数据、封面和同步歌词的媒体文件。Gamdl 命令行下载 Apple Music 歌曲的使用界面示意环境自查先检查这 5 项不同功能依赖不同组件。对照下表过一遍缺哪项补哪项其余可以完全忽略。组件用途是否必需获取方式Python 3.10运行 gamdl 本体必需Python 官网安装包Apple Music 订阅 Cookies 文件授权访问你的曲库与流媒体接口必需登录 music.apple.com 后用浏览器扩展把 Cookies 导出为 Netscape 格式的cookies.txtFirefox 可用 Export Cookies 扩展Chromium 可用 get cookies.txt LOCALLY 扩展N_m3u8DL-RE更快的下载模式--download-mode nm3u8dlre可选从其项目 Releases 页下载可执行文件FFmpeg使用 nm3u8dlre 模式时必需条件必需各包管理器均有brew/winget/aptWrapper v2接管账号、播放与解密请求下载 ALAC 无损音质时推荐启用可选Wrapper v2 项目发布版本一个常见误区以为必须把所有可选组件都装齐。实际上默认模式ytdlp下你只需要 Python、订阅和 Cookies 就能开始下载。三步上手从安装到第一次下载成功第 1 步安装pip install gamdl如果偏好从源码构建git clone https://gitcode.com/GitHub_Trending/ga/gamdl cd gamdl pip install .第 2 步放置 Cookies把上一步导出的cookies.txt放到工作目录即你运行gamdl的目录首次运行后 gamdl 会在~/.gamdl/config.iniWindows 为%USERPROFILE%\.gamdl\config.ini自动生成配置文件命令行参数会覆盖其中的值。第 3 步下载第一首歌在 Apple Music 网页版中打开歌曲页点分享 → 拷贝链接然后gamdl https://music.apple.com/us/album/never-gonna-give-you-up-2022-remaster/1624945511?i1624945512下载完成后文件默认保存在当前目录下的Apple Music/文件夹按艺人/专辑自动分好目录并写好标签、封面和 LRC 同步歌词。分场景用法下载整张专辑、歌手或歌单直接把对应页面链接丢给 gamdl它支持歌曲、专辑、歌单、音乐视频、艺人主页、发布视频等 URL 类型gamdl https://music.apple.com/us/album/whenever-you-need-somebody-2022-remaster/1624945511 gamdl https://music.apple.com/us/artist/rick-astley/669771遇到艺人主页时终端会弹出交互选择界面用方向键移动、空格勾选、Ctrl A全选、回车确认。也可以加--artist-auto-select让程序自动选择下载内容类型。下载音乐视频最高 4K音乐视频走同一命令默认 1080p、H.264 优先gamdl https://music.apple.com/us/artist/rick-astley/669771 --music-video-resolution 2160p注意1440p与2160p只有 H.265 编码提供且 4K 解码需要 DRM 设备文件——Widevine L1 的.wvd或 PlayReady SL3000 的.prd通过--wvd-path/--prd-path指定。下载更高音质ALAC 无损默认歌曲编解码是aac-webAAC 256kbps。要拿 ALAC最高 24-bit/192kHz建议启用 wrapper-v2 服务并开启--use-wrappergamdl --use-wrapper --song-codec-priority alac 歌曲 URL不开 wrapper 强行指定alac也可以尝试但官方明确提示受 API 限制大概率失败。其他可选编解码包括atmos杜比全景声、ac3、aac-he等用--song-codec-priority以逗号分隔排列优先级。想要更快的下载速度换用 N_m3u8DL-RE 作为下载引擎gamdl --download-mode nm3u8dlre 歌曲 URL若可执行文件不在 PATH 中用--nm3u8dlre-path和--ffmpeg-path显式指定位置。参数速查常用命令行参数一览完整选项见gamdl --help与 README.md参数含义默认值--output-path,-o输出目录./Apple Music--cookies-path,-cCookies 文件路径./cookies.txt--download-mode下载模式ytdlp/nm3u8dlreytdlp--use-wrapper通过 wrapper 处理账号、播放与解密false--song-codec-priority歌曲编解码优先级逗号分隔aac-web--music-video-resolution音乐视频最高分辨率1080p--no-synced-lyrics不下载同步歌词false--synced-lyrics-format同步歌词格式lrc/srt/ttmllrc--language,-l元数据语言ISO 639-1如en-US、ja-JPen-US--overwrite覆盖已存在的文件false--save-cover,-s将封面另存为独立文件false--save-playlist保存 M3U8 歌单文件false--read-urls-as-txt,-r把参数中的 URL 文件按 txt 逐行读取false--album-folder-template专辑目录命名模板{album_artist}/{album}--drm-backendDRM 后端widevine/playreadywidevine排障诊断按现象 → 原因 → 解决排查多数问题落在下面几条里现象可能原因解决办法启动即提示 No active Apple Music subscription found订阅已到期或 Cookies 过期/导出时未登录确认订阅有效后重新登录 music.apple.com 导出cookies.txt覆盖旧文件启用alac后下载失败或跳过未启用 wrapper受 API 限制拿不到无损流运行 wrapper-v2 服务并加--use-wrapper切换到nm3u8dlre模式报错N_m3u8DL-RE 或 FFmpeg 不在 PATH将可执行文件放入 PATH或用--nm3u8dlre-path/--ffmpeg-path指定4K 音乐视频解密失败缺少 DRM 设备文件提供 Widevine L1.wvd--wvd-path或 PlayReady SL3000.prd--prd-path同时--drm-backend playready文件已存在跳过下载默认不覆盖确认无误后加--overwrite强制重写部分内容无法下载账号开启了内容限制日志有 warning这是账号侧限制检查 Apple 账号的内容限制设置个别曲目报 Skipping 警告该媒体不可流播、无可用格式或已注册跳过属正常行为检查日志中具体原因即可不影响其他曲目日志级别不够清晰时用--log-level DEBUG提高详细度或--log-file落盘排查。收尾Gamdl 用一条命令 一个 Cookies 文件就能把 Apple Music 的歌、MV 和发布视频以高质量格式沉淀进你自己的本地曲库。【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdl创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考