Gamdl 完整配置指南3 套身份模板快速搭出高质量 Apple Music 下载库【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdlGamdl 是一款面向 Apple Music 下载的命令行工具支持歌曲、音乐视频与发布视频。本文聚焦进阶配置的四个痛点质量组合怎么选、文件库怎么管、引擎与稳定性怎么平衡、高频错误怎么修并给出三套拿来即用的配置。先定身份三套拿来即用的 Gamdl 配置配置 Gamdl 时最容易犯的错是想把不同场景的需求揉进同一组参数。更省事的做法是先明确自己是哪类用户再定参数无损收藏党输出路径~/Music/AppleMusic按「艺术家 / 年份 / 专辑」三层归档目录模板{album_artist}/{date:%Y}/{album}质量组合--song-codec-priority alac,atmos,aacALAC 受 API 限制基本需要配合--use-wrapper才稳定可用移动轻量党输出路径~/MobileMusic目录模板{artist}/{album}并设--truncate 50控制文件名长度质量组合--song-codec-priority aac-he-web,aac-web视频走720p h264单文件体积可控内容创作者输出路径~/Projects/Media/AppleMusic与工程素材同盘管理目录模板{artist}/{album}文件用--playlist-file-template {playlist_title} - {date:%Y%m%d}之类的模板保留版本信息质量组合2160p h265 mp4。注意2160p只有 h265 流提供且 4K 需要 Widevine L1.wvd或 PlayReady SL3000.prd设备以无损收藏党为例一条可落地的完整命令如下批量抓取某艺术家全部专辑gamdl --use-wrapper \ --output-path ~/Music/AppleMusic \ --album-folder-template {album_artist}/{date:%Y}/{album} \ --song-codec-priority alac,atmos,aac \ --music-video-resolution 1080p \ --artist-auto-select all-albums \ ARTIST_URLGamdl 编解码器选择场景 → 推荐组合决策表不用逐个背编解码器直接按播放场景查表使用场景音频优先级视频分辨率视频编码 / 容器Hi-Fi / 家庭影院alac→atmos→aac需--use-wrapper1080ph265mp4电脑日常播放aac→aac-web1080ph264 / h265m4v移动端 / 快速下载aac-web720ph264m4v存储紧张aac-he-web64kbps480ph264m4v4K 电视atmos→aac2160p仅 h265 流h265mp4需 L1 / SL3K 设备--song-codec-priority与--music-video-codec-priority都接受逗号分隔的优先级列表gamdl 会按顺序取第一个可用流所以写出降级链本身就是标准用法。拿不准时先用默认组合aac-web 1080p h264跑顺后再逐步上调。用模板变量管好文件库 模板系统控制所有文件夹与文件命名常用变量压缩如下变量含义示例值{album}/{album_artist}专辑名 / 专辑艺术家Midnights / Taylor Swift{artist}曲目艺术家含合作艺人A feat. B{title}/{track}/{track_total}标题 / 轨号 / 总轨数Snow On The Beach / 4 / 13{disc}/{disc_total}碟号 / 总碟数1 / 2{date:%Y-%m}发行日期strftime 格式化2022-10{playlist_title}/{playlist_artist}播放列表名 / 创建者Todays Hits / Apple Music{media_type}媒体类型song / music-video数字变量支持 Python 格式化语法{track:02d}会输出04。--exclude-tags用于排除写盘的具体标签逗号分隔传all可跳过全部打标。把下面这段直接写进~/.gamdl/config.ini文件库规则就能一次固化、长期生效[gamdl] output_path ~/Media/AppleMusic album_folder_template {album_artist}/{date:%Y}/{album} compilation_folder_template Various Artists/{date:%Y}/{album} single_disc_file_template {track:02d} - {title} multi_disc_file_template {disc:02d}-{track:02d} {title} exclude_tags comment,copyright,genre_id,rating truncate 80几个高频小技巧合辑专辑用compilation_folder_template单独收拢避免散进各艺术家目录exclude_tags lyrics,comment能减小元数据体积文件名超长报错时优先加truncate。引擎与稳定性yt-dlp 对比 N_m3u8DL-RE维度yt-dlp默认N_m3u8DL-RE切换方式--download-mode ytdlp--download-mode nm3u8dlre速度中等更快适合批量下载稳定性高装完即用中等强依赖 FFmpeg额外依赖无需指定--nm3u8dlre-path与--ffmpeg-pathyt-dlp 在 gamdl 中只承担文件下载过程本身媒体流仍直接来自 Apple Music 服务器API 层也内置了重试传输。弱网环境下与其硬扛高并发不如先降一档质量、开日志观察gamdl --download-mode nm3u8dlre \ --nm3u8dlre-path /usr/local/bin/N_m3u8DL-RE \ --ffmpeg-path /usr/local/bin/ffmpeg \ --log-level DEBUG --log-file gamdl.log \ URL日常建议关键专辑用默认ytdlp模式保稳定大播放列表切nm3u8dlre抢速度两者共用同一套质量参数随时可互换。三个高频错误的修复1. 指定的编解码器不可用症状下载被跳过或报错日志提示拿不到请求的流原因该曲在你的 storefront 地区没有对应流或没启用 wrapper 就去抓alac修复把优先级改成降级链确需alac时补上--use-wrapper2. 存储空间不足症状大播放列表下载到一半中断留下半截文件原因1080p 视频加高码率音频单文件体积大临时文件与成品同盘修复降分辨率 换高效音频输出路径挪到外置盘3. 元数据写入失败症状媒体文件本身完整打标环节报错原因个别字段不兼容lyrics、rating、storefront 等修复用--exclude-tags排除问题字段实在不行用all跳过全部打标三条问题的修复命令合在一起# 编解码器降级链 gamdl --song-codec-priority aac,aac-web,aac-he-web URL # 转存外置盘 低规格 gamdl --music-video-resolution 480p --song-codec-priority aac-he-web \ --output-path /external/AppleMusic URL # 排除问题标签或改用 --exclude-tags all gamdl --exclude-tags lyrics,rating,comment URL五分钟配置速查表维度 × 身份维度无损收藏党移动轻量党内容创作者输出路径~/Music/AppleMusic~/MobileMusic~/Projects/Media/AppleMusic目录模板{album_artist}/{date:%Y}/{album}{artist}/{album}{artist}/{album}音频优先级alac,atmos,aacwrapperaac-he-web,aac-webaac,aac-web视频组合1080p · h265 ·mp4720p · h264 ·m4v2160p · h265 ·mp4下载引擎ytdlpnm3u8dlreytdlp歌词 / 标签保留 lrc、完整标签--no-synced-lyricsexclude_tags lyrics,comment默认 --save-cover把常用组合固化成 alias日常调用只敲一个词alias gamdl-hqgamdl --song-codec-priority alac,atmos,aac --music-video-resolution 1080p alias gamdl-fastgamdl --song-codec-priority aac-he-web --music-video-resolution 720p --download-mode nm3u8dlre alias gamdl-batchgamdl --artist-auto-select all-albums --overwrite false写在最后没有一套参数通吃所有场景最佳 Gamdl 配置取决于你的播放设备、存储预算与网络条件——从默认值出发一次只调一个维度、用同一张专辑验证比一次改十几个参数收敛得快得多。延伸学习gamdl/cli/config_file.py配置文件如何读取、与命令行参数合并并回写默认值gamdl/interface/enums.py编解码器、分辨率、模板等全部枚举取值gamdl/downloader/base.py下载器主流程与分片并发等下载侧细节【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdl创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
