PirateBay：终端种子搜索下载工具

项目简介

PirateBay 是一个用 Rust 编写的命令行工具，可以在终端里搜索并下载 The Pirate Bay、Nyaa、Bitsearch、LimeTorrents、TorrentDownload 上的种子。项目为纯 Rust 实现，基于 tokio 异步，不依赖原生 C 库，同时提供交互式 TUI、可脚本化的 CLI 和可复用的库。

主要功能

• 交互式 TUI（基于 ratatui）：搜索、按分类浏览、查看详情、下载、复制磁力链接都不用离开终端
• 一次并发查询多个站点，按 info hash 合并去重；搜索结果按做种数排序，分类浏览按最新排序
• 分类浏览：音频、视频、应用、游戏、XXX、其他
• 内置纯 Rust 种子下载器（librqbit，仅使用 rustls）
• 下载时显示实时进度条、速度（字节/秒）与预计剩余时间
• --stream 模式把种子中最大的文件边下载边输出到 stdout，可直接接 mpv、VLC、ffplay
• 通过 OSC 52 把磁力链接复制到系统剪贴板，SSH 环境下同样可用
• 所有读取类命令支持 --json，方便接到 jq 等工具
• 可作为异步 Rust 库使用：use piratebay::pirateclient::PirateClient

安装与使用

安装方式（节选）：

curl -fsSL https://raw.githubusercontent.com/tsirysndr/piratebay/main/install.sh | bash
cargo install piratebay
brew install tsirysndr/tap/piratebay

不带参数运行即启动 TUI：

piratebay
piratebay tui -o ~/Downloads

常用 CLI 命令：

piratebay search "debian 12"
piratebay info 72614907
piratebay category --video
piratebay download 72614907 --output ~/Downloads
piratebay download 'magnet:?xt=urn:btih:...' --stream | mpv -

用全局参数 --source（-S）限制查询来源，例如 piratebay -S nyaa search "frieren"。来源 ID 为 tpb、nyaa、bitsearch、limetorrents、torrentdownload。

注意事项

• info 和 download <id> 只接受 The Pirate Bay 的 id；其他来源请用磁力链接下载（--json 输出中包含磁力链接）。
• Bitsearch 在没有 API key 时每个 IP 每天 200 次请求，可通过 PIRATEBAY_BITSEARCH_API_KEY 提升到每天 1000 次。
• 站点域名变化时，可用 PIRATEBAY_<ID>_URL 指向镜像，例如 PIRATEBAY_LIMETORRENTS_URL=https://www.limetorrents.lol。
• 某个来源请求失败时，其余来源的结果仍会显示，并在 stderr 打印警告。
• Nyaa 与 LimeTorrents 没有 XXX 分类；TorrentDownload 仅支持搜索，不支持分类浏览。
• 项目以 MIT 许可证开源。

---

本作品整理自 GitHub 开源项目 tsirysndr/piratebay，原作者 @tsirysndr，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。