gamdl 配置调优实战：下载路径、视频分辨率、音频编码一行命令搞定

gamdl 配置调优实战：下载路径、视频分辨率、音频编码一行命令搞定

【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdl

gamdl 是一个下载 Apple Music 歌曲、音乐视频和 post 视频的命令行工具。这篇文章带你过 4 个最常用的配置项：文件存哪、视频多清、音质选什么、下载怎么提速，每个都是一行命令的事，改完还能写进配置文件长期生效。

配置项总览

配置文件首次运行时会在~/.gamdl/config.ini自动生成，INI 格式，所有默认值都会写进去，直接编辑保存即可。优先级是：命令行参数 > 配置文件 > 默认值。

指定下载保存路径的方法

就是控制文件落在哪儿。默认存在当前目录的./Apple Music文件夹里，换个地方运行一次，库就散一地。我一般把它写进配置文件，省得每次手敲：

gamdl -o ~/Music/Apple_Music <URL>

[gamdl] output_path = ~/Music/Apple_Music

改完之后，所有下载都会落到你指定的目录，目录不存在会自动创建，不用提前手动建。

⚠️ 目标目录需要有写权限，放共享目录或只读挂载点会直接报权限错误，选自己有权限的目录就行。

限制音乐视频分辨率的方法

这个参数是"分辨率上限"，不是精确匹配，gamdl 会挑不超过它的、最接近的档位。默认值定义在音乐视频接口里，不改就是 1080p：

gamdl --music-video-resolution 720p <URL>

改完之后，4K 音源也只下载 720p 的版本，体积明显小一截。这个值不改也能跑，改了更省空间。

⚠️ 想下 4K 得先确认手里有合格的.wvd/.prd设备文件，没有的话别硬设 2160p，1080p 以下就够用。

设置歌曲音频编码优先级的方法

Apple Music 的歌曲源有好几种编码，这个参数是逗号分隔的优先级列表，按顺序挑第一个音源支持的。如果你只关心音质，直接选无损就行：

gamdl --song-codec-priority alac,aac-web,aac <URL>

改完之后按顺序挑，音源没有 alac 就自动落到 aac-web（256kbps AAC），不会报错中断。

⚠️alac基本要配合--use-wrapper才能下成功，裸试 ALAC 大概率失败，别把它放第一位瞎试。

切换下载引擎加速下载的方法

默认走 yt-dlp，下几首没问题，整个专辑或播放列表就比较慢。换 nm3u8dlre 引擎能提速：

gamdl --download-mode nm3u8dlre <URL>

改完之后下载阶段交给 N_m3u8DL-RE 处理，整张专辑、整份歌单能省不少时间。

⚠️ 这个模式要同时装 N_m3u8DL-RE 和 FFmpeg，不在系统 PATH 里的话用--nm3u8dlre-path和--ffmpeg-path指定一下。

踩坑速查

Q: 配置文件到底在哪？什么格式？A: 首次运行后在~/.gamdl/config.ini（Windows 在用户主目录的.gamdl\config.ini），INI 格式，所有参数都在[gamdl]段下。写错的 key 会被自动清掉，读写逻辑在配置文件处理里。

Q: 改了配置文件里的值，感觉没生效？A: 命令行参数优先，只有命令行没传的值才会读配置文件。加个--no-config-file跑一次对比，就能确认差异出在哪。

Q: 同一个文件重新下，显示跳过或没保存？A: 默认目标文件已存在就不重复下载，加--overwrite强制覆盖即可。

其余配置（封面格式、文件命名模板、wrapper 等）在gamdl --help和官方仓库 README 里都有完整列表，格式与上面一致，直接照抄进配置文件就行。

【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdl