作者官网#

1
https://github.com/mikf/gallery-dl

介绍#

命令行程序，用于从多个图片托管网站下载图片画廊和收藏

步骤#

1.安装gallery-dl.exe程序#

2.浏览器下载Get cookies.txt#

官网

https://chromewebstore.google.com/detail/get-cookiestxt-locally/cclelndahbckbenkjhflpdbgdldlbecc

3.获得x的cookies.txt，放入文件夹#

4.地址栏输入 %APPDATA%\gallery-dl#

1
%APPDATA%\gallery-dl

新建config.json存到这个文件夹里面了

config.json代码折叠/展开

1
{
2
  "extractor": {
3
    "twitter": {
4
      "cookies": "D:/OTHERS/tools/gallery-dl/cookies.txt",
5
      "retweets": false,
6
      "replies": false,
7
      "images": true,
8
      "videos": true,
9
      "directory": [
10
        "twitter",
11
        "{author[name]}"
12
      ],
13
      "filename": "{date:%Y%m%d}_{tweet_id}_{num}.{extension}",
14
      "download-archive": "D:/OTHERS/tools/gallery-dl/archive.txt"
15
    }
16
  },
17
  "output": {
18
    "mode": "auto",
19
    "timestamp": true
20
  }
21
}

其中D:/OTHERS/tools/gallery-dl/cookies.txt 更换成自己的cookies.txt的位置

5.命令行指令#

如果没有在PATH里面添加环境变量用

1
.\gallery-dl.exe https://x.com/用户名

如何把gallery-dl.exe 加入PATH 点击折叠/展开

win + R
sysdm.cpl
高级-环境变量
PATH-编辑-新建-D:/OTHERS/tools/gallery-dl
确定-…-确定

如果在PATH里添加过环境变量用

1
gallery-dl.exe https://x.com/用户名

如果没写config.json 用

1
.\gallery-dl.exe --cookies cookies.txt https://x.com/用户名

或者（如果没有在PATH里面添加环境变量）用

1
gallery-dl.exe --cookies cookies.txt https://x.com/用户名

额外功能#

1.只下载某个时间区间的推文里的图片/视频#

gallery-dl 支持用 —date 或 —dateafter / —datebefore 来实现。

指定开始时间（包含当天）：

1
--dateafter YYYY-MM-DD

指定结束时间（包含当天）：

1
--datebefore YYYY-MM-DD

同时指定：

1
.\gallery-dl.exe https://x.com/用户名 --dateafter 2025-11-01 --datebefore 2025-11-30

✅ 只下载 2025-11-01 到 2025-11-30 的推文内容。

2.只下载视频/图片#

只下载图片：

1
--filter "is:photo"

只下载视频：

1
--filter "is:video"

结合时间区间：

1
.\gallery-dl.exe https://x.com/用户名 --filter "is:photo"

3.增量下载（只下载新内容）#

新建一个archive.txt

方法 A：使用下载记录（推荐）#

1
--download-archive "D:/OTHERS/tools/gallery-dl/archive.txt"

✅ 原理：

gallery-dl 会把已经下载过的推文 ID 记录在 archive.txt

下次再运行时，只下载新推文里的媒体

已经存在的文件会跳过，节省时间和流量

方法 B：只检查本地文件（自动跳过重复文件）#

如果你文件名包含推文 ID + 序号，gallery-dl 默认不会重复下载完全相同的文件

但是推荐用 —download-archive 更稳

1
--download-archive "D:/OTHERS/tools/gallery-dl/archive.txt" --skip

gallery-dl 会：

跳过 archive.txt 里已有的推文
跳过文件名已存在的文件
只下载新的图片/视频
自动把新推文 ID 写入 archive.txt

已下载但未存入 archive.txt 的文件可以用 —skip + —download-archive 命令自动同步，无需手动操作；下次就只会下载新推文的内容。