Gamdl命令行参数大全：从基础到高级的实用选项-CSDN博客

Gamdl命令行参数大全：从基础到高级的实用选项

Gamdl（Glomatico's Apple Music Downloader）是一款强大的命令行工具，专为从Apple Music下载音乐和视频内容而设计。本指南将详细介绍Gamdl的所有命令行参数，帮助新手和高级用户充分利用这款工具的全部功能。

Gamdl的基本命令格式为：

gamdl [OPTIONS] URLS...

-r, --read-urls-as-txt
将输入的URLs视为文本文件路径，从文件中读取下载链接（每行一个URL）。
-o, --output-path PATH
指定下载文件的保存目录，默认路径为当前工作目录。
示例：--output-path ~/Music/AppleDL
--temp-path PATH
设置临时文件目录，默认使用系统临时文件夹。

--config-path PATH
指定配置文件路径，默认位于 ~/.gamdl/config.ini。
配置文件可保存常用参数，避免重复输入。
-n, --no-config-file
禁用配置文件，仅使用命令行参数。

--log-level LEVEL
设置日志级别，可选值：DEBUG、INFO、WARNING、ERROR，默认 INFO。
调试时推荐使用 DEBUG 级别获取详细信息。
--log-file PATH
将日志输出到指定文件，而非仅显示在控制台。
--no-exceptions
禁止打印异常堆栈信息，仅显示错误摘要。

--download-mode MODE
设置下载模式，可选值：NM3U8DLRE（默认）、PYTHON。
NM3U8DLRE 需要指定 -nm3u8dlre-path。
--remux-mode MODE
设置音视频合并模式，可选值：FFMPEG（默认）、MP4BOX。
工具路径参数
指定外部工具路径，如：
- --ffmpeg-path PATH：FFmpeg可执行文件路径
- --mp4decrypt-path PATH：mp4decrypt路径（用于DRM解密）
- --nm3u8dlre-path PATH：N_m3u8DL-RE下载器路径

--song-codec CODEC
指定音频编码格式，可选值：AAC_LEGACY（默认）、AAC_HE_LEGACY、ALAC（无损）等。
注：部分编码需启用 --use-wrapper。
歌词控制
- --no-synced-lyrics：禁用同步歌词下载
- --synced-lyrics-only：仅下载同步歌词（不下载音频）
- --synced-lyrics-format FORMAT：设置歌词格式（LRC 或 JSON）

--music-video-resolution RES
设置音乐视频的最大分辨率，可选值：720p、1080p、2160p（默认 1080p）。
--uploaded-video-quality QUALITY
设置上传视频（如演唱会录像）的质量，可选值：LOW、MEDIUM、HIGH（默认 HIGH）。

Gamdl支持通过模板自定义文件和文件夹命名：

文件夹模板
- --album-folder-template TEMPLATE：专辑文件夹命名模板
  默认：{album_artist}/{album} ({year})
- --compilation-folder-template TEMPLATE：合辑文件夹模板
- --no-album-folder-template TEMPLATE：无专辑信息时的文件夹模板
文件模板
- --single-disc-file-template TEMPLATE：单碟文件命名模板
  默认：{track:02d} - {title}
- --multi-disc-file-template TEMPLATE：多碟文件模板
  默认：Disc {disc}/{track:02d} - {title}

--date-tag-template FORMAT
设置日期标签格式，默认 %Y-%m-%d。
--exclude-tags TAGS
排除不需要的元数据标签（逗号分隔），如 --exclude-tags copyright,encoded_by。
--cover-size SIZE
设置封面图片尺寸（像素），默认 1200（推荐保持默认以获取高清封面）。

下载专辑并保存到指定目录：

gamdl -o ~/Music/AppleDL https://music.apple.com/us/album/example-album/123456789

使用无损编码、保存封面、生成播放列表：

gamdl --song-codec ALAC --save-cover --save-playlist --overwrite https://music.apple.com/playlist/url

保存常用参数到配置文件：

# ~/.gamdl/config.ini
output_path = ~/Music/AppleDL
song_codec = ALAC
save_cover = true
log_level = INFO

然后直接运行：

gamdl https://music.apple.com/song/url

Q: 下载失败提示"无活跃订阅"？
A: 确保cookies文件有效且包含Apple Music订阅信息，路径通过 --cookies-path 指定。
Q: 视频下载后无法播放？
A: 检查FFmpeg是否正确安装，或尝试切换 --remux-mode MP4BOX。
Q: 如何批量下载多个链接？
A: 将URLs写入文本文件，使用 --read-urls-as-txt 选项：
gamdl -r urls.txt

通过灵活组合以上参数，Gamdl可以满足各种Apple Music内容的下载需求。无论是简单的单曲下载，还是复杂的批量采集，这些选项都能帮助你高效完成任务。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考