gamdl 快速上手批量下载 Apple Music 无损音频与 4K 音乐视频【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdlgamdlGlomaticos Apple Music Downloader是一个命令行工具用于批量下载 Apple Music 的歌曲、音乐视频和创作者上传的 post videos。它面向有订阅、想把媒体留在本地的用户粘贴链接原始质量的文件直接落盘标签、封面、同步歌词一并写入。能力一览gamdl 能拿回哪些内容模块内容与规格相关参数默认值 歌曲音频AAC 256kbps、ALAC 最高 24-bit/192kHz、Dolby Atmos 768kbps 等--song-codec-priorityaac-web 音乐视频240p–2160ph264/h265可重封装为 m4v 或 mp4--music-video-resolution1080pPost video创作者上传内容最高 1080p AAC 256kbps--uploaded-video-qualitybest 歌词与元数据LRC/SRT/TTML 同步歌词标题、艺术家、专辑、日期、封面等标签--synced-lyrics-formatlrc 批量与去重艺术家自动选择、URL 文本文件、SQLite 记录去重--artist-auto-select、-r、--database-path支持的链接范围覆盖曲库Catalog与资料库Library中的歌曲、专辑、播放列表、音乐视频、艺术家以及 Apple Music Classical。从安装到第一次下载一条连贯流程Python 3.10 以上即可装完就有gamdl命令pip install gamdl账号侧只需在浏览器登录 music.apple.com用导出 Cookie 的扩展按 Netscape 格式存成cookies.txt放到工作目录也可以用--cookies-path指向别处。随后把任意一首歌的分享链接粘进去运行gamdl https://music.apple.com/us/album/never-gonna-give-you-up-2022-remaster/1624945511?i1624945512文件写入默认的./Apple Music目录按艺术家/专辑归类标签和封面一并写进文件。首次运行会在~/.gamdl/自动生成config.iniWindows 为%USERPROFILE%\.gamdl\同名命令行参数优先于配置。粘入专辑或艺术家页面时会弹出选择框方向键移动、空格选中、CtrlA 全选、回车确认。按目标调参四种常用玩法同一条链接参数不同结果不同。四个常见目标对应如下配置无损音质的下载命令ALACApple Lossless Audio Codec是无损上限默认编码是 aac-web用优先级显式指定gamdl URL --song-codec-priority alac,aac-web提醒ALAC 通常需要配合 Wrapper v2 本地解密服务——跑起 wrapper 后在配置里写use_wrapper true解密端口默认 10020不想部署时退回 aac-web仍是 256kbps。4K 音乐视频参数怎么配1440p/2160p 只有 h265 流4K 还要求 DRM 设备Widevine L1.wvd或 PlayReady SL3K.prdgamdl URL --music-video-resolution 2160p \ --music-video-codec-priority h265 --music-video-remux-format m4v设备兼容性存疑时把优先级写成h264,h265即默认顺序可自动兜到 1080p h264。批量收藏一位艺术家的全部作品粘入艺术家页面后直接指定下载哪些类型省去逐条复制链接gamdl 艺术家URL --artist-auto-select main-albums,singles-eps,top-songs规模更大时把 URL 逐行写入文本文件用-r读取、--database-path记录重复运行不重复下载gamdl -r urls.txt --database-path ./history.db自定义文件夹与文件命名模板默认文件夹模板是{album_artist}/{album}文件名模板是{track:02d} {title}。按年份归档、剔除多余标签、另存高清封面可以这样写gamdl URL --album-folder-template {album_artist}/{date:%Y}/{album} \ --exclude-tags comment,genre_id --save-cover --cover-format png --cover-size 2000模板变量与可排除标签的完整清单在 README.md 的 Configuration 一节。排障速查五个高频问题Cookie 文件从哪来、放哪登录 Apple Music 网页版后用扩展按 Netscape 格式导出放工作目录命名cookies.txt或用-c指定路径。走 Wrapper v2 时可以跳过 Cookie由 wrapper 账号直接登录。下载后的文件默认在哪当前工作目录下的./Apple Music文件夹。用-o改输出目录--temp-path改临时文件位置。为什么下不了 4K 音乐视频两个条件缺一不可1440p/2160p 仅有 h265 流且 4K 需要 Widevine L1.wvd或 PlayReady SL3K.prd设备分别用--wvd-path、--prd-path指定。只想给本地曲库补歌词必须连带音频一起下吗不必。--synced-lyrics-only只产出同步歌词文件不下载音频配合--synced-lyrics-format选 lrc/srt/ttml。同一条链接跑两遍会重复下载吗指定--database-path后gamdl 把已下载媒体记入本地 SQLite 数据库重复运行自动跳过未配数据库的普通运行则用--overwrite控制是否覆盖已有文件。给开发者三层架构与作为库嵌入项目职责分三层gamdl/api/ 对接 Apple Music 官方 API登录态、媒体元数据、license 交换interface 层负责流地址解析、解密密钥、标签与封面gamdl/downloader/ 负责下载、解密、合流、打标签的执行管线。解密与 MP4/M4A 写入的重活由 Rust 扩展_ammuxer完成源码在 gamdl/downloader/ammuxer/经 pyo3 嵌入 PythonCLI 入口在 gamdl/cli/cli.py。嵌入自己的项目时核心骨架如下api await AppleMusicApi.create_from_netscape_cookies(cookies.txt) base await AppleMusicBaseInterface.create(apple_music_apiapi) interface AppleMusicInterface( songAppleMusicSongInterface(basebase), music_videoAppleMusicMusicVideoInterface(basebase), uploaded_videoAppleMusicUploadedVideoInterface(basebase), ) base_dl AppleMusicBaseDownloader(interfaceinterface) dl AppleMusicDownloader( songAppleMusicSongDownloader(basebase_dl), music_videoAppleMusicMusicVideoDownloader(basebase_dl), uploaded_videoAppleMusicUploadedVideoDownloader(basebase_dl), ) async for item in dl.get_download_item_from_url(url): await dl.download(item)三类名称分别从gamdl.api、gamdl.interface、gamdl.downloader导入get_download_item_from_url返回异步生成器天然适配批量任务带 asyncio 入口的完整版本见 README.md 的 Embedding 一节。接下来可以做把config.ini里的output_path指到 NAS 或外接盘language改成zh-CN之后不必再敲长参数串部署 Wrapper v2 并将use_wrapper置为true用alac,aac-web优先级跑一张专辑实际对比无损效果把-r urls.txt --database-path history.db写进定时任务定期增量更新某位艺术家的新内容并自动去重【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdl创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考