gallery-dl使用指南

gallery-dl使用指南

一般选项

• -h,--help:打印帮助信息并退出
• --version:打印程序版本并退出
• -i,--input-file 文件:从指定文件中读取下载地址,文件为-表示从标准输入读取。可以指定多个--input-file
• -f,--filename 格式:下载文件的文件名格式字符串,'/O'表示使用原始文件名
• -d,--destination 路径:设置下载文件保存的目标位置
• -D,--directory 路径:设置下载文件保存的具体位置
• -X,--extractors 路径:从指定路径加载外部extractor
• --proxy URL:设置代理服务器
• --source-address IP:设置客户端源IP地址用于绑定
• --user-agent UA:设置User-Agent请求头
• --clear-cache 模块:删除指定模块的缓存登录会话、Cookie等数据(ALL表示删除所有缓存)

输出选项

• -q,--quiet:启用安静模式
• -v,--verbose:打印详细的调试信息
• -g,--get-urls: 打印URL而不是下载文件
• -G,--resolve-urls:打印URL而不是下载文件;解析中间URL
• -j,--dump-json:打印JSON信息
• -s,--simulate:模拟数据提取而不下载任何内容
• -E,--extractor-info:打印extractor的默认设置和配置信息
• -K,--list-keywords:打印可用的关键字和示例值列表
• --list-modules:打印可用的extractor模块列表
• --list-extractors:打印extractor类及其描述、(子)类别和示例URL
• --write-log 文件:将日志输出写入指定文件
• --write-unsupported 文件:将其他extractor发出但本程序无法处理的URL写入指定文件
• --write-pages:将下载的中间页写入当前目录的文件中以助于调试

下载器选项

• -r,--limit-rate 速率:最大下载速率(例如500k或2.5M)
• -R,--retries N:失败的HTTP请求最大重试次数,-1表示无限重试(默认为4)
• --http-timeout 秒:HTTP连接超时时间(默认为30.0秒)
• --sleep 秒:每个下载前的等待秒数,可以是常数或范围(例如2.7或2.0-3.5)
• --sleep-request 秒:数据提取期间HTTP请求之间的等待秒数
• --sleep-extractor 秒:开始为输入URL提取数据前的等待秒数
• --filesize-min 大小:不下载小于指定大小的文件(例如500k或2.5M)
• --filesize-max 大小:不下载大于指定大小的文件(例如500k或2.5M)
• --chunk-size 大小:内存数据块的大小(默认为32k)
• --no-part:不使用.part文件
• --no-skip:不跳过下载,覆盖已存在的文件
• --no-mtime:不根据Last-Modified HTTP响应头设置文件修改时间
• --no-download:不下载任何文件
• --no-postprocessors:不运行任何后处理过程
• --no-check-certificate:禁用HTTPS证书验证

配置选项

• -o,--option 键=值:附加选项,例如-o browser=firefox
• -c,--config 文件:附加配置文件
• --config-yaml 文件:附加YAML格式的配置文件
• --config-toml 文件:附加TOML格式的配置文件
• --config-create:创建一个基本的配置文件
• --config-ignore:不读取默认配置文件

认证选项

• -u,--username 用户:登录用户名
• -p,--password 密码:所给用户名对应的密码
• --netrc:启用.netrc认证数据

Cookie选项

• -C,--cookies 文件:从指定文件加载额外Cookie
• --cookies-export 文件:导出会话Cookie到指定文件
• --cookies-from-browser 浏览器[/域][+密钥环][:配置文件][::容器]:从指定浏览器加载Cookie,可选的域名前缀为’/‘,密钥环前缀为’+‘,配置文件前缀为’:‘,容器前缀为’::‘(无容器为’none’)

选择选项

• --download-archive 文件:记录所有已下载或跳过的文件,跳过文件中已有的任何文件
• -A,--abort N:在连续跳过N个文件下载后停止当前extractor
• -T,--terminate N:在连续跳过N个文件下载后停止当前和父extractor
• --range 范围:指定要下载的索引范围,可以是常数、范围或切片(例如’5’、‘8-20’或’1:24:3’)
• --chapter-range 范围:类似--range,但应用于漫画章节和其他委托URL
• --filter 表达式:控制要下载哪些文件的Python表达式。对表达式计算为False的文件将被忽略。可用的键是-K列出的特定于文件名的键。例如:--filter "image_width >= 1000 and rating in ('s', 'q')"
• --chapter-filter表达式:类似--filter,但应用于漫画章节和其他委托URL

后处理选项

• --zip:将下载的文件存档到ZIP中
• --ugoira-conv:将Pixiv Ugoira转换为WebM(需要FFmpeg)
• --ugoira-conv-lossless:将Pixiv Ugoira无损转换为WebM VP9
• --ugoira-conv-copy:将Pixiv Ugoira转换为MKV,不重新编码任何帧
• --write-metadata:将元数据写入单独的JSON文件
• --write-info-json:将图库元数据写入info.json文件
• --write-tags:将图像标签写入单独的文本文件
• --mtime-from-date:根据’date’元数据设置文件修改时间
• --exec 命令:为每个下载的文件执行命令。支持的替换字段有{}或{_path}、{_directory}、{_filename}。例如:--exec "convert {} {}.png && rm {}"
• --exec-after 命令:所有文件下载成功后执行命令。例如:--exec-after "cd {_directory} && convert * ../doc.pdf"
• -P,--postprocessor 名称:激活指定的后处理过程
• -O,--postprocessor-option 选项:附加的'<key>=<value>'后处理过程选项