toMedia
基本用法

过滤与筛选

按条件筛选要下载的内容

🔍 过滤与筛选

--filter 表达式

gallery-dl 支持 Python 表达式来过滤下载内容:

# 只下载 JPG 和 PNG 图片
gallery-dl --filter "extension in ('jpg','jpeg','png')" "URL"

# 只下载 1920x1080 以上的图片
gallery-dl --filter "width >= 1920 and height >= 1080" "URL"

# 只下载 2024 年以后的内容
gallery-dl --filter "date >= datetime(2024, 1, 1)" "URL"

# 只下载有特定标签的内容
gallery-dl --filter "'landscape' in tags" "URL"

--range 范围选择

# 下载第 1-10 个
gallery-dl --range "1-10" "URL"

# 下载第 5 个之后的所有
gallery-dl --range "5-" "URL"

# 下载最后 3 个
gallery-dl --range "-3-" "URL"

在配置文件中设置过滤

{
  "extractor": {
    "twitter": {
      "filter": "extension in ('jpg','jpeg','png','gif') and retweet_id == 0"
    },
    "pixiv": {
      "filter": "type == 'illust' and bookmark_count >= 100"
    }
  }
}

文件大小过滤

{
  "extractor": {
    "filesize-min": "100k",
    "filesize-max": "50m"
  }
}

跳过已存在的文件

# 文件已存在时跳过
gallery-dl --no-skip=false "URL"

配置文件方式:

{
  "extractor": {
    "skip": true
  }
}

--filter 表达式中可以使用 -j 输出的任何元数据字段。先用 gallery-dl -j "URL" 查看可用字段。

On this page