基本用法
输出模板
自定义文件名和目录结构
📂 输出模板
目录模板
通过配置文件设置下载目录结构：
{
"extractor": {
"base-directory": "./downloads/",
"directory": ["{category}", "{subcategory|user|'unknown'}"]
}
}命令行方式：
gallery-dl -D "./downloads/" "URL"文件名模板
{
"extractor": {
"filename": "{id}_{title|filename}.{extension}"
}
}命令行方式：
gallery-dl -o "filename={id}_{num:>03}.{extension}" "URL"常用元数据字段
| 字段 | 说明 | 示例 |
|---|---|---|
{id} | 帖子/图片 ID | 1234567890 |
{title} | 标题 | My Photo |
{user} / {author} | 作者名 | username |
{category} | 网站名 | twitter |
{subcategory} | 子分类 | tweet |
{filename} | 原始文件名 | photo_001 |
{extension} | 文件扩展名 | jpg |
{num} | 图片序号 | 1 |
{date} | 发布日期 | 2024-01-15 12:30:00 |
日期格式化
{
"extractor": {
"filename": "{date:%Y%m%d}_{id}.{extension}"
}
}输出：20240115_1234567890.jpg
按网站自定义
{
"extractor": {
"twitter": {
"directory": ["twitter", "{user[name]}"],
"filename": "{tweet_id}_{num:>02}.{extension}"
},
"instagram": {
"directory": ["instagram", "{username}"],
"filename": "{post_id}_{num:>02}.{extension}"
}
}
}查看可用字段
# 输出 JSON 格式的元数据，查看所有可用字段
gallery-dl -j "URL" | head -20模板支持 Python 格式化语法，如 {num:>03} 表示3位数字右对齐补零（001, 002, ...）。