https://github.com/unkmonster/tmd
批量下载推特上用户的媒体推文，支持通过用户列表和关注列表进行批量下载。
https://github.com/unkmonster/tmd
cli downloader twitter x
Last synced: 5 months ago
JSON representation
批量下载推特上用户的媒体推文，支持通过用户列表和关注列表进行批量下载。
- Host: GitHub
- URL: https://github.com/unkmonster/tmd
- Owner: unkmonster
- License: gpl-3.0
- Created: 2024-06-19T15:42:32.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2025-07-02T09:49:10.000Z (12 months ago)
- Last Synced: 2025-07-02T10:46:05.079Z (12 months ago)
- Topics: cli, downloader, twitter, x
- Language: Go
- Homepage:
- Size: 382 KB
- Stars: 186
- Watchers: 3
- Forks: 22
- Open Issues: 17
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# Twitter Media Downloader
[](https://pkg.go.dev/github.com/unkmonster/tmd)
[](https://goreportcard.com/report/github.com/unkmonster/tmd)
[](https://coveralls.io/github/unkmonster/tmd?branch=master)
[](https://github.com/unkmonster/tmd/actions/workflows/go.yml)
跨平台的推特媒体下载器。用于轻松，快速，安全，整洁，批量的下载推特上用户的推文。支持手动指定用户或通过列表、用户关注批量下载。开箱即用！
## Feature
- 下载指定用户的媒体推文 (video, img, gif)
- 保留推文标题
- 保留推文发布日期，设置为文件的修改时间
- 以列表为单位批量下载
- 关注中的用户批量下载
- 在文件系统中保留列表/关注结构
- 同步用户/列表信息：名称，是否受保护，等。。。
- 记录用户曾用名
- 避免重复下载
- 每次工作后记录用户的最新发布时间，下次工作仅从这个时间点开始拉取用户推文
- 向列表目录发送指向用户目录的符号链接，无论多少列表包含同一用户，本地仅保存一份用户存档
- 避免重复获取时间线：任意一段时间内的推文仅仅会从 twitter 上拉取一次，即使这些推文下载失败。如果下载失败将它们存储到本地，以待重试或丢弃
- 避免重复同步用户（更新用户信息，获取时间线，下载推文）
- 速率限制：避免触发 Twitter API 速率限制
- 自动关注受保护的用户
- 添加备用 cookie：提高推文获取速度和总数量
## How to use
### 下载/编译
**直接下载**
前往 [Release](https://github.com/unkmonster/tmd/releases/latest) 自行选择合适的版本并下载
**自行编译**
```bash
git clone https://github.com/unkmonster/tmd
cd tmd
go build .
```
### 更新/填写配置
第一次运行程序时，程序会询问如下配置信息，请按要求将配置项依次填入
#### 配置项介绍
1. `storeage path`：存储路径(可以不存在)
2. `auth_token`：用于登录，[获取方式](https://github.com/unkmonster/tmd/blob/master/doc/help.md#获取-cookie)
3. `ct0`：用于登录，[获取方式](https://github.com/unkmonster/tmd/blob/master/doc/help.md#获取-cookie)
4. `max_download_routine`：最大并发下载协程数（如果为0取默认值）
#### 更新配置
```shell
tmd --conf
```
> **执行上述命令将导致引导配置程序重新运行，这将重新配置整个配置文件，而不是单独的配置项。单独修改配置项**请至 `%appdata%/.tmd2/conf.yaml` 或 `$HOME/.tmd2/conf.yaml`手动修改
### 命令说明
```
tmd --help // 显示帮助
tmd --conf // 重新运行配置程序
tmd --user // 下载由 user_id 指定的用户的推文
tmd --user // 下载由 screen_name 指定的用户的推文
tmd --list // 批量下载由 list_id 指定的列表中的每个用户
tmd --foll // 批量下载由 user_id 指定的用户正关注的每个用户
tmd --foll // 批量下载由 screen_name 指定的用户正关注的每个用户
tmd --auto-follow // 自动关注受保护的用户
tmd --no-retry // 仅转储，不在程序退出前自动重试下载失败的推文
```
> 为了创建符号链接，在 Windows 上应该以管理员身份运行程序
[不知道啥是 user_id/list_id/screen_name?](https://github.com/unkmonster/tmd/blob/master/doc/help.md#%E8%8E%B7%E5%8F%96-list_id-user_id-screen_name)
### 示例
```
tmd --user elonmusk // 下载 screen_name 为 ‘eronmusk’ 的用户
tmd --user 1234567 // 下载 user_id 为 1234567 的用户
tmd --list 8901234 // 下载 list_id 为 8901234 的列表
tmd --foll 567890 // 下载 user_id 为 567890 的用户正关注的所有用户
```
更推荐的做法：一次运行
```shell
tmd --user elonmusk --user 1234567 --list 8901234 --foll 567890
```
### 设置代理
运行前通过环境变量指定代理服务器（TUN 模式跳过这一步）
```bash
set HTTP_PROXY=url
set HTTPS_PROXY=url
```
示例：
```bash
set HTTP_PROXY=http://127.0.0.1:7890
set HTTPS_PROXY=http://127.0.0.1:7890
tmd --user elonmusk
```
如果你使用windows系统，在powershell中使用以下指令设置代理：
```powershell
$Env:HTTP_PROXY="http://127.0.0.1:7890"
$Env:HTTPS_PROXY="http://127.0.0.1:7890"
```
### 忽略用户
程序默认会忽略被静音或被屏蔽的用户，所以当你想要下载的列表中包含你不想包含的用户，可以在推特将他们屏蔽或静音
### 添加额外 cookie
程序动态从所有可用 cookie 中选择一个不会被速率限制的 cookie 请求用户推文，以避免因单一 cookie 的速率限制导致程序被阻塞。
按如下格式创建 `$HOME/.tmd2/additional_cookies.yaml` 或 `%appdata%/.tmd2/additional_cookies.yaml`
```yaml
- auth_token: xxxxxxxxx1
ct0: xxxxxxxxxxxxxxxxxxxxxxx
- auth_token: xxxxxxxxx2
ct0: xxxxxxxxxxxxxxxx2
- auth_token: xxxxxxxxxxxxxxxx3
ct0: xxxxxxxxxxxxxxxxxxxxx3
```
> 这些添加的备用 cookie，仅用来提升获取推文的速率和总量。判断是否忽略用户和自动关注受保护的用户依然使用主账号
## Detail
### 关于速率限制
Twitter API 限制一段时间内过快的请求 （例如某端点每15分钟仅允许请求500次，超出这个次数会以429响应），当某一端点将要达到速率限制程序会打印一条通知并阻塞尝试请求这个端点的协程直到余量刷新（这最多是15分钟），但并不会阻塞所有协程，所以其余协程打印的消息可能将这条休眠通知覆盖让人认为程序无响应了，等待余量刷新程序会继续工作。
## Contributors
## 交流群
tg: https://t.me/+I4yyM81HaJpkNTll
## 感谢
本项目 CDN 加速及安全防护由 Tencent EdgeOne 赞助：EdgeOne 提供长期有效的免费套餐，包含不限量的流量和请求，覆盖中国大陆节点，且无任何超额收费，感兴趣的朋友可以点击下面的链接领取
亚洲最佳CDN、边缘和安全解决方案 - Tencent EdgeOne
