Gamdl 配置指南输出路径、视频分辨率和音频编码一次设明白【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdl用 GamdlGlomaticos Apple Music Downloader下载 Apple Music最容易被问到的其实就三件事文件存到哪、清晰度怎么定、音质选什么编码。这三个配置项都能通过命令行参数或~/.gamdl/config.ini配置文件设定且命令行优先于配置文件。下面按先跑通、再调参数、最后固化的顺序把该设的都列清楚。第一次跑通最小下载命令Gamdl 需要三样东西Python 3.10、有效的 Apple Music 订阅、一份 Netscape 格式的 cookies 文件。装好之后pip install gamdl gamdl https://music.apple.com/us/album/never-gonna-give-you-up-2022-remaster/1624945511?i1624945512cookies 文件默认找当前目录的./cookies.txt不在此处时用-c或--cookies-path指定路径。第一次运行会在~/.gamdl/config.iniWindows 为%USERPROFILE%\.gamdl\config.ini自动生成配置文件并把所有参数的默认值写进去方便你直接改文件而不是记命令。把文件存到指定目录默认所有下载内容落在当前目录的./Apple Music文件夹。换位置有两个入口参数作用默认值--output-path/-o下载目录路径./Apple Music--temp-path临时文件目录.当前目录gamdl -o ~/Music/Apple_Downloads [URL]路径优先级是命令行 配置文件 内置默认值这个规则由 gamdl/cli/config_file.py 里的update_params_from_config实现只要某个参数在命令行被显式传入配置文件里的同名项就会被跳过。除了总目录目录和文件名结构还能用模板改默认是{album_artist}/{album}加{track:02d} {title}。想按歌手归档、或限制文件名长度对应--album-folder-template、--single-disc-file-template、--truncate。临时文件默认写当前目录下载量大时建议用--temp-path指到空间更大的盘。视频分辨率怎么选--music-video-resolution的语义是最大分辨率默认1080p。它不会精确锁定某一档而是在码流里挑不超过该值、且最接近的那条流同差距时取分辨率更高、再取码率更高的匹配逻辑在 gamdl/interface/music_video.py 的_get_video_playlist_from_resolution。可选档位档位可用的视频编码240p360p480p540p720p1080pH.264 或 H.2651440p2160p4K仅 H.265且需要 Widevine L1 的.wvd或 PlayReady SL3000 的.prd设备文件gamdl --music-video-resolution 720p [URL]两点和默认编码强相关档位必须小写、带p写成720或720P会直接报错。视频编码优先级--music-video-codec-priority默认h264,h265若只想省体积传h265即可。4K 档位必须配合 H.265 流否则找不到匹配流、该条目会被跳过。音频编码与输出格式 先说结论Gamdl 不做转码选的是用哪条音轨不是输出成什么格式。歌曲固定输出 M4A 容器音乐视频默认输出 M4V可用--music-video-remux-format mp4改成 MP4 容器。--song-codec-priority默认aac-web支持逗号分隔的多级回退某个编码在该曲不可用时自动尝试下一个全部不可用才跳过这条编码说明备注aac-web默认AAC 256kbps 44.1kHz无需额外依赖aac-he-webAAC-HE 64kbps 44.1kHz体积小aacaac-binauralaac-downmixAAC 256kbps最高 48kHz非 web 流aac-he及其 binaural/downmixAAC-HE 64kbps最高 48kHz非 web 流atmosDolby Atmos 768kbps非 web 流ac3AC3 640kbps非 web 流alacALAC 最高 24bit/192kHz强烈建议配 wrapperask运行时交互选择适合批量时逐条确认alac不开--use-wrapper时启动会打印告警因为 API 限制下大概率取不到该流建议按提示搭配 wrapper 使用。用配置文件固化设置 ⚙️首次运行后~/.gamdl/config.ini里已经写好了全部默认值直接改文件即可持久化键名与命令行参数对应去掉--、用下划线[gamdl] output_path ~/Music/Apple_Downloads music_video_resolution 720p music_video_remux_format mp4几个实操要点命令行传了的参数配置文件里的同名项不生效临时覆盖互不冲突。想完全不用配置文件加-n--no-config-file想换个路径用--config-path。配置文件里的未知键会被自动清掉。⚠️ 歌曲编码的键名是song_codec_piority源码字段名如此拼写不是song_codec_priority。写错键名不会报错但设置不生效还可能在下次运行时被清理掉。下载出问题时按顺序排查 看最后一行Finished with N error(s)区分是报错还是被跳过跳过会打印Skipping 标题: 原因不计数。路径相关--output-path在启动时校验可写不可写会直接失败换一个你有写权限的目录即可临时文件落在--temp-path确认该盘有足够空间。分辨率不生效先查拼写必须小写、带p再确认该视频在所选编码下真有对应档位H.264 最高 1080p4K 仅 H.265 且有 DRM 设备要求最后注意 1080p 语义是上限源里若是 720p 就不会给你 1080p。音频/解码相关alac没配 wrapper 属于已知限制某编码该曲没有时会自动回退到优先级里下一个全部没有才跳过。4K 解不出来时检查是否提供了 Widevine L1.wvd或 PlayReady SL3000.prd。下载慢或中断默认走 yt-dlp 下载可换--download-mode nm3u8dlre需另装 N_m3u8DL-RE 与 FFmpeg路径不在 PATH 里时用--nm3u8dlre-path、--ffmpeg-path指定。推荐组合把固定项写进~/.gamdl/config.ini临时需求走命令行是一套省心的默认方案[gamdl] output_path ~/Music/Apple_Downloads music_video_resolution 1080p song_codec_priority aac-web music_video_remux_format mp4即歌曲用默认aac-web256kbps兼容性最好视频上限 1080p容器统一 MP4。想省空间就把分辨率降到720p、编码加h265想追音质再加--use-wrapper并把song_codec_priority换成alac。【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdl创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考