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 的歌曲、音乐视频和帖子视频。装好之后大多数人都直接用默认值，但想换保存目录、压低画质省空间、或者调整编码格式时，就得动配置。本文按"文件放哪里 → 画质怎么取舍 → 编码怎么选 → 出错怎么排查"的顺序，把常用配置一次讲清。
📁 先说文件落盘：下载内容默认会放进当前工作目录下的./Apple Music文件夹。你能用--output-path（短参数-o）把它指到任意位置：
gamdl -o "~/Music/Downloads" [URL 参数]临时用一次就够的话，命令行参数最方便。想长期生效，就写进配置文件。配置文件默认在 Linux 上是~/.gamdl/config.ini，Windows 上是%USERPROFILE%\.gamdl\config.ini，首次运行 Gamdl 会自动创建，格式是 INI 而不是 TOML：
[gamdl] output_path = ~/Music/Downloads取值规则是三级覆盖：命令行参数 > 配置文件 > 内置默认值（./Apple Music）。所以日常建议把固定的路径写死在配置文件里，临时改目录时再敲参数，互不干扰。这套优先级逻辑在 配置模块源码 里能看到，输出路径的默认值定义在 下载器基类。
🎬 再说音乐视频的清晰度。--music-video-resolution参数接受 8 个档位：240p、360p、480p、540p、720p、1080p、1440p、2160p，默认是1080p：
gamdl --music-video-resolution 720p [视频 URL]选档时不用纠结它是否"精确命中"：Gamdl 会从视频源实际提供的码流里，挑最接近你指定值的分辨率，优先取不超过指定值的档位，同档再比带宽高低，选择逻辑在 音乐视频接口 中。所以源端没有 720p 时，它会自动落到相邻档位，不会因为"没有精确选项"就失败。
视频编码则由--music-video-codec-priority控制，可填h264、h265、ask（交互式询问），默认顺序是 h264 优先、h265 兜底；下载完成后容器默认为 m4v，也可通过--music-video-remux-format改为 mp4。
音频这边和"格式转换"是两回事，先把概念分清：Gamdl 下载的是 Apple Music 原始码流解密后的结果，不做 mp3、flac 之类的转码。你真正能配的是编码优先级——当一首歌有多种码流可用时，按你列的顺序挑：
gamdl --song-codec-priority aac-web,aac [歌曲 URL]--song-codec-priority用逗号分隔，可选值包括aac-web、aac-he-web、aac、aac-he、aac-binaural、aac-downmix、atmos、ac3、alac，以及ask（运行时逐个询问）。默认只列了aac-web。想要更高保真度就把alac、atmos排前面；追求兼容性或省空间则保持默认。注意优先级只对源端实际提供的码流生效——列表里写了源端没有的编码，就跳过继续看下一个，这是 歌曲接口 的遍历逻辑。
🔧 出错时按顺序查三处：
- 权限报错：确认输出目录可写，或者换一个你有写权限的目录；
- 找不到可执行文件：下载流程依赖
ffmpeg和N_m3u8DL-RE，两者要么在 PATH 里，要么用--ffmpeg-path指定完整路径； - 指定分辨率下不到：先看视频源是否提供该档位的码流，再检查
--music-video-codec-priority里的编码是否和源端匹配； - 重复下载想覆盖：加
--overwrite开关（默认 false，已下载过的会跳过）。
配置速查：
| 配置键 | 对应参数 | 默认值 | 作用 |
|---|---|---|---|
output_path | --output-path/-o | ./Apple Music | 下载文件的保存目录 |
music_video_resolution | --music-video-resolution | 1080p | 音乐视频最高分辨率 |
music_video_codec_priority | --music-video-codec-priority | h264,h265 | 视频编码选择顺序 |
music_video_remux_format | --music-video-remux-format | m4v | 音乐视频输出容器 |
song_codec_priority | --song-codec-priority | aac-web | 歌曲编码选择顺序 |
overwrite | --overwrite | false | 是否覆盖已下载文件 |
最后一句实用信息：配置文件里每个键名和命令行参数一一对应，跑一次带--help的命令就能拿到当前版本的全部参数清单，比查文档更准。
【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdl
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
