批量下载推特上用户的媒体推文，支持通过用户列表和关注列表进行批量下载。
Twitter Media Downloader
跨平台的推特媒体下载器。用于轻松，快速，安全，整洁，批量的下载推特上用户的推文。支持手动指定用户或通过列表、用户关注批量下载。开箱即用！
Feature
- 下载指定用户的媒体推文 (video, img, gif)
- 保留推文标题
- 保留推文发布日期，设置为文件的修改时间
- 以列表为单位批量下载
- 关注中的用户批量下载
- 在文件系统中保留列表/关注结构
- 同步用户/列表信息：名称，是否受保护，等。。。
- 记录用户曾用名
- 避免重复下载
- 避免重复获取时间线：任意一段时间内的推文仅仅会从 twitter 上拉取一次，即使这些推文下载失败。如果下载失败将它们存储到本地，以待重试或丢弃
- 避免重复同步用户（更新用户信息，获取时间线，下载推文）
- 速率限制：避免触发 Twitter API 速率限制
- 自动关注受保护的用户
- 添加备用 cookie：提高推文获取速度和总数量
How to use
下载/编译
直接下载
前往 Release 自行选择合适的版本并下载
自行编译
git clone https://github.com/unkmonster/tmd
cd tmd
go build .更新/填写配置
第一次运行程序时，程序会询问如下配置信息，请按要求将配置项依次填入
配置项介绍
更新配置
tmd --conf执行上述命令将导致引导配置程序重新运行，这将重新配置整个配置文件，而不是单独的配置项。单独修改配置项请至%appdata%/.tmd2/conf.yaml或$HOME/.tmd2/conf.yaml手动修改
命令说明
tmd --help // 显示帮助
tmd --conf // 重新运行配置程序
tmd --user <userid> // 下载由 userid 指定的用户的推文
tmd --user <screenname> // 下载由 screenname 指定的用户的推文
tmd --list <listid> // 批量下载由 listid 指定的列表中的每个用户
tmd --foll <userid> // 批量下载由 userid 指定的用户正关注的每个用户
tmd --foll <screenname> // 批量下载由 screenname 指定的用户正关注的每个用户
tmd --auto-follow // 自动关注受保护的用户
tmd --no-retry // 仅转储，不在程序退出前自动重试下载失败的推文为了创建符号链接，在 Windows 上应该以管理员身份运行程序
不知道啥是 userid/listid/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 的用户正关注的所有用户更推荐的做法：一次运行
tmd --user elonmusk --user 1234567 --list 8901234 --foll 567890设置代理
运行前通过环境变量指定代理服务器（TUN 模式跳过这一步）
set HTTP_PROXY=url
set HTTPS_PROXY=url示例：
set HTTP_PROXY=http://127.0.0.1:7890 set HTTPS_PROXY=http://127.0.0.1:7890 tmd --user elonmusk如果你使用windows系统，在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/additionalcookies.yaml 或 %appdata%/.tmd2/additionalcookies.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
