toMedia

速查表

gallery-dl 常用命令速查

基础命令

命令说明
gallery-dl "URL"下载 URL 内容
gallery-dl -g "URL"列出文件列表(不下载)
gallery-dl -j "URL"输出 JSON 元数据
gallery-dl -i urls.txt批量下载
gallery-dl --version查看版本
gallery-dl -U更新(pip安装时用 pip install -U gallery-dl

下载控制

命令说明
--range "1-20"只下载第 1-20 个
--filter "EXPR"按条件过滤
--download-archive FILE归档避免重下
--no-skip不跳过已存在文件
-D PATH指定下载目录
-o "key=value"设置配置选项

认证

命令说明
--cookies-from-browser chrome使用浏览器 Cookies
--cookies FILE使用 cookies 文件
-u USER -p PASS用户名密码

网络

命令说明
--proxy URL设置代理
--rate-limit RATE限速
-R N重试次数

配置文件

命令说明
-c FILE使用指定配置文件
--config-ignore忽略配置文件
--config-create创建示例配置

常用过滤表达式

# 只要图片
--filter "extension in ('jpg','jpeg','png','webp','gif')"

# 只要视频
--filter "extension in ('mp4','webm','mov')"

# 大于 1MB
--filter "filesize > 1048576"

# 2024 年以后
--filter "date >= datetime(2024, 1, 1)"

# Pixiv 收藏数 > 100
--filter "bookmark_count >= 100"

# Twitter 排除转推
--filter "retweet_id == 0"

完整配置模板

{
  "extractor": {
    "base-directory": "./gallery-dl/",
    "archive": "./gallery-dl/archive.sqlite3",
    "proxy": "http://127.0.0.1:7890",
    "sleep": [1.0, 3.0],

    "twitter": {
      "cookies-from-browser": "chrome",
      "retweets": false,
      "directory": ["twitter", "{user[name]}"],
      "filename": "{tweet_id}_{num:>02}.{extension}"
    },
    "instagram": {
      "cookies-from-browser": "chrome",
      "stories": true,
      "highlights": true,
      "directory": ["instagram", "{username}"],
      "filename": "{post_id}_{num:>02}.{extension}"
    },
    "pixiv": {
      "cookies-from-browser": "chrome",
      "ugoira": true,
      "directory": ["pixiv", "{user[name]}"],
      "filename": "{id}_p{num:>02}.{extension}"
    },
    "weibo": {
      "cookies-from-browser": "chrome",
      "directory": ["weibo", "{user[screen_name]}"]
    }
  },
  "downloader": {
    "rate": null,
    "retries": 4,
    "timeout": 30.0
  },
  "postprocessor": [
    {"name": "mtime"}
  ]
}

On this page