如何把 Apple Music 无损音质和 4K 音乐视频存到本地Gamdl 命令行完整攻略【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdl订阅里的歌下了飞机就没得听。想用命令行把 Apple Music 下载成本地文件可以试试 Gamdl它支持最高 24-bit/192kHz 的无损音乐下载和 4K 音乐视频单曲、专辑、播放列表、艺术家页面都能批量处理。先划清边界能下什么、上限在哪先看你想要的东西在不在 Gamdl 的能力范围内。这张表把内容、上限、前置条件一次说清内容类型能拿到什么上限前置条件歌曲目录/资料库AAC 256kbps、ALAC、Dolby Atmos 768kbps、AC3 等ALAC 最高 24-bit/192kHz有效订阅 cookiesALAC 建议配 Wrapper v2音乐视频H.264 / H.265从 240p 起H.264 止于 1080p4K2160p仅限 H.2654K 需要 Widevine L1.wvd或 PlayReady SL3000.prd设备文件上传视频Post Videos最高 1080p AAC 256kbpsbest 档1080p同歌曲艺术家页面专辑、单曲、MV 批量用--artist-auto-select圈定范围main-albums、top-songs、music-videos 等同上歌词与元数据同步歌词 LRC/SRT/TTML封面、艺术家标签自动写入封面默认 1200px JPG无DRM 部分一句话讲透Apple Music 的流是加密的Gamdl 默认走 Widevine 后端用内置 WVD 设备文件换出解密密钥wvd.py里就内嵌了一个默认 WVD加--use-wrapper后FairPlay 流改由 Wrapper v2 服务器批量解密默认 TCP 10020 端口解不了的流再回落到 Widevine/PlayReady。解密和 MP4/M4A 封装由仓库内置的 Rust 扩展完成Python 侧只管流程编排。装好 Gamdl 并下载第一首歌需要 Python 3.10 和一个有效的 Apple Music 订阅其余都能一步步验证。pip install gamdl然后准备 cookies在浏览器登录 music.apple.com 后用浏览器扩展把 cookie 导出为 Netscape 格式的cookies.txtFirefox 和 Chromium 都有现成扩展放到工作目录即可或用--cookies-path指定别的路径。跑第一条命令gamdl https://music.apple.com/us/album/never-gonna-give-you-up-2022-remaster/1624945511?i1624945512✅ 验证方式默认输出到./Apple Music目录里面会出现一个带完整标签的音频文件。首次运行还会自动生成配置文件Linux 在~/.gamdl/config.iniWindows 在%USERPROFILE%\.gamdl\config.ini以后命令行参数和配置文件二选一都行命令行优先。无损音质怎么开音质、4K 与命名模板按我想要什么效果对号入座每条都能直接跑。想要无损。优先级列表按顺序回退前面拿不到才用后面的gamdl URL --song-codec-priority alac,aac,aac-web --use-wrapper注意alac强依赖前面提到的 Wrapper v2 服务器不配的话大概率失败API 层面有限制其他格式aac、aac-web等不需要 wrapper。想要 Dolby Atmos。把它排到最前即可768kbps 空间音频gamdl URL --song-codec-priority atmos,alac,aac想要 4K 音乐视频。前提是你手里有 L1.wvd或 SL3000.prd设备文件否则 2160p 根本拿不到gamdl URL --music-video-resolution 2160p --music-video-codec-priority h265H.264 路线最高只有 1080p2160p 是 H.265 专属档。想要可控的目录结构。模板变量支持{album_artist}、{album}、{date:%Y}等日期支持 strftime 语法gamdl URL --album-folder-template {album_artist}/{date:%Y}/{album}想要干净的标签和独立封面。默认会嵌入封面和完整元数据多余字段可以排除语言用 ISO 639-1 代码默认en-USgamdl URL --save-cover --cover-format png --cover-size 2000 \ --exclude-tags comment,storefront --language zh-CN同步歌词默认存 LRC想要更精确的时间轴用--synced-lyrics-format srtttml是 Apple 原生格式但大部分播放器不认。批量下载不重复还能当 Python 库用URL 列表。每行一个链接存成urls.txt然后gamdl -r urls.txt数据库去重。指定一个 SQLite 文件下载过的媒体会按 id 记录在案第二次跑同一 URL 直接跳过gamdl URL --database-path ./downloads.db外挂下载引擎。默认走 yt-dlp但它只当纯下载库用媒体流仍直接从 Apple Music 服务器取换 N_m3u8DL-RE 通常更快它需要 FFmpeggamdl URL --download-mode nm3u8dlre \ --nm3u8dlre-path /opt/N_m3u8DL-RE --ffmpeg-path /usr/bin/ffmpeg当 Python 库集成。核心 API 在 gamdl/api/下载器在 gamdl/downloader/最小调用骨架如下interface 与 downloader 的完整组装见 README.md 的 Embedding 一节import asyncio from gamdl.api import AppleMusicApi from gamdl.interface import AppleMusicBaseInterface api await AppleMusicApi.create_from_netscape_cookies(cookies.txt) base await AppleMusicBaseInterface.create(apple_music_apiapi) # 组装 interface 和 downloader 后可用 api.active_subscription 预检订阅 async for item in downloader.get_download_item_from_url(url): await downloader.download(item)三层架构各管一段请求、密钥、落盘读源码前先看分工三分钟够API 层gamdl/api/httpx 直连 Apple Music 接口负责 cookies/Wrapper 认证、目录数据获取、订阅状态检查。接口层gamdl/interface/解析媒体信息、取 DRM 密钥wvd.py内嵌默认 Widevine WVD。下载层gamdl/downloader/下载、解密、封装、写标签。其中的ammuxer/是 Rust 扩展AES-CBC/CTR 解密 MP4/M4A 写入构建后以gamdl._ammuxer形式被 Python 调用。外部依赖里真正干活的是yt-dlp纯下载库HLS 分片 8 路并发、N_m3u8DL-RE FFmpeg可选、Wrapper v2可选、mutagen标签写入。边界与避坑限制、排错与红线⚠️ 这几条都是踩过的坑直接对照ALAC 没配 Wrapper v2官方说法是probably wont work别浪费重试。反过来用了 Wrapper 之后 cookies 可以省。4K 拿不到先检查有没有 L1.wvd或 SL3000.prd设备文件没有就认了 1080p 上限。语言参数--language只认 ISO 639-1 代码ja-JP、pt-BR且对音乐视频不一定生效。网络与速度代理走export HTTP_PROXY/HTTPS_PROXY环境变量想提速就切nm3u8dlre模式临时文件位置可用--temp-path指到 SSD。排错三板斧--log-level DEBUG --log-file ./gamdl.log看细节--no-exceptions让单条失败不中断整批输出目录用-o显式指定避免下错地方。红线只对你自己有效订阅的内容使用下载的文件仅供个人使用不要二次分发能下到哪些内容取决于你账号所属的 storefront 地区。它适合谁不适合谁Gamdl 适合会一点命令行、想把无损音质和 4K 音乐视频真正落到硬盘的人本地音乐库、离线收听、MV 素材收集都能覆盖Python API 也让二次集成有路可走。它不适合想一键操作、找图形界面的场景也只管 Apple Music 生态内的内容。社区入口方面项目目前只接受关键 bug 修复的提交功能建议以 issue 形式提出即可。【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdl创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考