Gamdl 实战：Apple Music 无损下载与 4K MV 快速上手

Gamdl 实战Apple Music 无损下载与 4K MV 快速上手【免费下载链接】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 下载工具它不靠录制或转码而是模拟客户端请求直接从官方接口拉原始编码文件——AAC 256kbps、最高 24-bit/192kHz 的 ALAC 无损、4K H.265 音乐视频标签和同步歌词一并写好。它只需要一个活跃订阅加一份浏览器 Cookie不依赖图形界面适合命令行用户和想把它嵌进自动化脚本的开发者。跑起来从零到第一次成功这一节带你完成安装、前置准备和第一次下载走完你能得到本地落盘的第一首歌。1. 安装要求 Python 3.10 或更高。确认版本并安装python --versionpip install gamdl再确认命令装对了gamdl --version成功标志终端打印出版本号当前为 3.9。2. 前置准备需要两样东西一个有活跃订阅的 Apple Music 账号一份 Netscape 格式的 Cookie 文件。用浏览器的Export Cookies类扩展在登录状态下把 music.apple.com 的 Cookie 导出为cookies.txt放在工作目录即可也可用-c参数指定其他路径。3. 第一条下载命令打开任意歌曲的 Apple Music 分享链接执行gamdl https://music.apple.com/us/album/never-gonna-give-you-up-2022-remaster/1624945511?i1624945512成功标志终端出现Starting Gamdl 3.9与Downloading ...进度./Apple Music目录按艺术家/专辑结构生成.m4a文件结尾打印Finished with 0 error(s)。默认同步歌词会以同名.lrc写入同一目录首次运行还会在~/.gamdl/config.ini自动生成一份完整配置命令行参数都有对应项命令行值优先。把核心功能用到实处这一节按使用频率给出四个任务每个都附验证方法做完你可以把批量、无损、4K、命名规则都用上。任务一批量下载 去重目标把多个链接一次下完定时重复运行不产生冗余文件。做法链接每行一条写入urls.txt用-r读取文件启用后参数里给的是 txt 路径而不是 URL并用--database-path指定一个 SQLite 数据库用于去重gamdl -r urls.txt --database-path ./history.db验证重跑一次已下过的条目日志出现Skipping ...: Registered in databasehistory.db文件存在。去重逻辑就几十行在 gamdl/cli/database.py存的是媒体 ID 到本地路径的映射。任务二无损音质ALAC 优先目标优先拿 ALAC 无损没有的曲目自动回落到 AAC 256kbps。做法ALAC 走非 Web 流受 API 限制纯 Cookie 模式大概率解不开README 明确建议配合本地 Wrapper v2 服务。先在~/.gamdl/config.ini的[gamdl]段开启[gamdl] use_wrapper true wrapper_url http://127.0.0.1 wrapper_decrypt_port 10020再下歌gamdl URL --song-codec-priority alac,aac-web验证用 ffprobe 看文件编码无损曲目应为alac24-bit/192kHz 规格以源文件为准没开 Wrapper 时终端会打印 ALAC 相关警告看到它就说明该启用use_wrapper。任务三4K 音乐视频目标把 MV 下成 H.265 封装的 4K 文件。做法三个参数必须一起给——分辨率、编码器、容器。H.264 编码器最高只到 1080p1440p/2160p 只有 H.265 提供gamdl URL --music-video-resolution 2160p --music-video-codec-priority h265 --music-video-remux-format m4v验证ffprobe -v error -select_streams v:0 -show_entries streamwidth,height,codec_name output.m4v验证输出应为 3840x2160、h265。任务四自定义目录与文件名目标用自己的模板控制归档结构单独存封面。做法gamdl URL --album-folder-template {album_artist}/{date:%Y}/{album} --single-disc-file-template {track:02d} {title} --save-cover --cover-format png --cover-size 2000验证输出目录变成艺术家/年份/专辑/01 曲目名.m4a结构且每首歌旁多出一份 2000 像素 PNG 封面。所有可用模板变量{album}、{artist}、{track:02d}等在 README 的 Template Variables 一节有完整清单。适用边界什么场景选它、什么场景别选这一节帮你判断自己是否在它的射程内避免装完才发现用不上。适合有活跃 Apple Music 订阅、想整专辑/整艺术家批量存档、需要去重和定时任务、或想把它当 Python 库嵌进自己项目API → Interface → Downloader 三层各自独立改哪层动哪层见 gamdl/api/ 与 gamdl/downloader/。不适合Tidal、Spotify 等其他平台——它只对接 Apple Music 官方接口无账号批量抓取需要图形界面的场景。想下普通网络视频直接用 yt-dlp 即可不必绕道。出问题了先看这里四个高频故障按现象 → 原因 → 解法排好先对号入座。现象启动即报No active Apple Music subscription found什么都下不了。原因Cookie 过期或订阅失效。解法重新登录 music.apple.com用扩展导出新的cookies.txt。现象选了alac却全部失败终端有 ALAC 警告。原因ALAC 需要 Wrapper 服务配合纯 Cookie 模式 API 解不开。解法本地跑起 Wrapper v2 并开启use_wrapper true不想折腾就退回aac-web256kbps。现象指定了 2160p文件实际只有 1080p。原因H.264 编码器不提供 4K 档。解法--music-video-codec-priority中放h265。现象批量任务中途报错后停止。原因默认会打印异常详情。解法加--no-exceptions让单条失败只记警告不中断配合--log-file ./gamdl.log事后排查。Gamdl 的价值可以收在三句话直连官方接口拿原始媒体标签与同步歌词自动写齐下载完成即成品三层架构让二次开发只动一层Python 库模式下get_download_item_from_url生成器加download方法就能驱动整条流水线。接下来三件事跑gamdl --version与第一条下载命令核对./Apple Music里的成品文件打开~/.gamdl/config.ini把output_path、song_codec_priority改成你的长期默认值顺着 gamdl/api/、gamdl/downloader/ 读调用链弄清请求 → 解析 → 解密 → 封装各在哪一层。【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdl创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考