一个跑在终端里的BT下载工具,全键盘操作,没有图形界面

torrent-tui 是一个跑在终端里的 BitTorrent 客户端，它只做一件事：在命令行里管理种子文件的下载、暂停、做种和删除，全键盘操作，不需要鼠标，不套任何图形界面。

传统 BT 客户端功能越堆越重，广告、弹窗、WebUI 一堆，启动慢、吃内存。

torrent-tui 把下载这件事拉回终端：输命令启动，a 加种子，j/k 上下选任务，Space 暂停恢复，d 移除种子，D 连已下载文件一起删，q 退出。没有多余交互。

已支持

• .torrent 元数据解析
• HTTP 和 UDP Tracker
• 节点握手与文件块下载
• 断点续传（数据保存在 ~/.local/state/torrent-tui/resume/）
• 多任务终端界面，任务列表、进度、状态一目了然

暂不支持

• 磁力链接（Magnet links）还没支持
• 没有独立的可执行二进制文件，目前必须通过 Bun 跑

任务状态

客户端对任务状态做了细分，不止“下载中”和“已完成”：

• 常规状态：排队中、校验中、连接节点中、下载中、已暂停、已停止
• Stalled（停滞）：种子未下完但当前没有可用节点，可以稍后按 Space 重试
• Seeding（做种）：所有文件块已下完，正在上传给其他节点
• Error（错误）：启动、存储或解析元数据失败

整个项目 99.7% 是 TypeScript 写的，目前依赖 Bun 运行。开发者计划在 npm CLI 发布路径稳定后推出独立二进制文件。

项目地址：https://github.com/ryadios/torrent-tui