torlink README

The project's README from github.com/baairon/torlink. As one markdown file: README.md.

torlink, curated torrents straight from your terminal

Finding a torrent these days sucks. One site is a minefield of fake download buttons. Another hides the real link under a popup that spawns two more tabs. And after all that, half the results are dead, zero seeders.

torlink is a torrent finder that lives in your terminal, with zero setup and nothing to configure. One search checks a short, curated list of reputable sources at once, and whatever you pick downloads straight to your computer. The files are yours, saved to your downloads folder.

Get started

  1. Install Node (from nodejs.org), it's all torlink needs.

  2. Open your terminal.

  3. Start it:

    npx torlnk

That's the only thing you'll type. torlink opens straight to a search bar: search for what you want, paste in a magnet link or a bare infohash, drag a .torrent file from your file manager onto the window, or just press Enter on an empty box to browse the curated library. From there it's all keypresses, nothing to memorize, and ? brings up the full list anytime.

Finding something

Type what you're looking for and press Enter. Results stream in from every source as they answer, tagged with size and how many people are sharing each one, so you can see what'll come down fast. Arrow to what you want and press d to save it, or shift+d to pick a different folder for just that download.

torlink's browse view: the sidebar, the search bar, and merged results from every source

Your downloads

Active downloads sit up top with their progress, speed, and time left; when one finishes it drops into Recently downloaded just below, so the list stays tidy. Everything's still there when you come back, and anything interrupted picks up where it left off.

Downloads run in the background while you keep searching, so you can queue up as many as you want. They save to your downloads folder, and the Downloads pane keeps tabs on each one; press o anytime to change where that is, or grab one result with shift+d to send it somewhere else without touching the default. When something finishes it keeps seeding automatically so the next person can find it too, and the Seeding tab lets you pause or stop that anytime.

torlink's Downloads pane: live progress on top, recently downloaded below

What it searches

A short, hand-picked list of trusted sources:

Category Sources
Games FitGirl
Movies YTS, The Pirate Bay, 1337x, BitTorrented
TV EZTV, The Pirate Bay, 1337x, BitTorrented
Anime Nyaa, SubsPlease

Games are the only category that can run code, so they come from FitGirl alone, a repacker with a long, trusted track record; everything else is plain video and subtitles. If a source is down, the search carries on without it, and torlink tells you which one is offline.

Headless

torlink also runs without the TUI, for servers and seedboxes:

torlnk search "<query>" [--category games|movies|tv|anime]
                        print one JSON document of merged search results
torlnk seed <path>    share files you already have
torlnk watch <dir>    download anything dropped into a folder
torlnk serve          take magnets over HTTP
torlnk files          stream finished downloads over HTTP
torlnk attach         keep the TUI alive across ssh sessions

Add --daemon to keep seed, watch, serve, or files running after you log out; torlnk --help has the full list of modes and flags.

Sharing something of your own

Everything else starts with a torrent someone else made. seed goes the other way:

torlnk seed ./album

It turns the folder into a torrent, saves album.torrent next to it, prints the magnet, and starts sharing right away. Send anyone the magnet and they pull the files from you.

serve takes a .torrent as well as a magnet, so you can hand it one you already have:

POST /add {"magnet":"magnet:?xt=..."}
POST /add {"torrent":"<base64>"}

Either can carry a seedTime for that one torrent, in the same grammar as --seed-time ("30d", "2h"; 0 means never stop). It wins over the daemon-wide flag, so a box that normally drops seeds after a couple of hours can keep one release alive for a month. Change it later, or on something already downloading, through the control endpoint:

POST /control {"id":"<info hash>","action":"seed-time","seedTime":"30d"}

GET /downloads reports the limit and when it falls due (seedUntil) on every torrent that has one.

Contributing

To run or work on torlink locally:

  1. Clone the repository and open the folder.
  2. Install dependencies:
    npm install
  3. Run the development version:
    npm run dev
    Or build it and run the bundled version:
    npm run build
npx torlnk

Before opening a PR, skim CONTRIBUTING.md; it lays out the bar with examples from real merged PRs.

Privacy

Your files stay on your disk, and nothing routes through a central server; torlink only talks to the torrent network directly. Once a download finishes it keeps seeding by default, sharing it back so the next person can find it just as easily. The network only works because people pass things along, and even a few minutes makes a real difference. If you'd rather not, opt out anytime: open the Seeding tab, press p to pause or stop any item, and press it again to pick it back up. Always your call.

torlink (baairon/torlink)

Searching Database…

5.9K ·GitHub
Torlink
这是什么？torlink 是一个完全在终端里运行的种子搜索与下载工具。它会同时搜索一小批精选、可信的种子站点，并把你选中的内容直接保存到下载文件夹。
这是图形界面应用还是终端工具？它是用 Ink 和 React 构建的终端界面（TUI），所有操作都在终端窗口里通过按键完成，而不是鼠标点击。它还提供无界面的 CLI 模式，适用于服务器，会完全跳过 TUI。
怎么让它运行起来？从 nodejs.org 安装 Node.js，然后在终端中运行启动命令。torlink 会直接打开一个搜索框，你可以在里面输入关键词、粘贴 magnet 链接或 infohash，也可以把 .torrent 文件拖到窗口上。
除了 Node 之外还需要别的东西吗？不需要，Node.js（22 或更高版本）是唯一的要求；其他依赖，比如种子引擎（'webtorrent'）和终端界面库（'ink'），都已经打包在应用里了。
它是搜索所有网站，还是只搜少数几个？每个类别只使用人工挑选的少数来源：游戏只用 FitGirl；电影用 YTS、The Pirate Bay、1337x 和 BitTorrented；电视剧用 EZTV 以及同样的三个站点；动画用 Nyaa 和 SubsPlease。游戏只来自 FitGirl，因为它是唯一可以运行可执行代码的来源。如果其他任何来源无法访问，torlink 会直接跳过并告诉你。
torlink 会把我的下载或活动数据发送到任何服务器吗？不会。文件保存在你自己的磁盘上，torlink 直接与种子网络通信，中间没有任何中央服务器；下载完成后，默认会继续做种以帮助他人，但你可以随时暂停。
我到底能搜索什么？四个类别，每个类别都有精选来源：游戏（仅 FitGirl）、电影（YTS、The Pirate Bay、1337x、BitTorrented）、电视剧（EZTV 以及上述另外三个）、动画（Nyaa、SubsPlease）。搜索结果会实时显示，并附带文件大小和做种者数量。
torlink 能在远程服务器上以无界面模式运行吗？可以，'torlnk' 命令行工具提供 search、seed、watch、serve、files 和 attach 等子命令，可以在没有 TUI 的情况下运行，还包括一个 HTTP API，用于添加 magnet 链接和控制做种，适合 seedbox 这类远程服务器。
我能分享自己的文件，而不只是下载别人的吗？可以，运行 'torlnk seed ./folder' 就能把任何文件夹变成种子，并在旁边保存 .torrent 文件，同时打印出一个 magnet 链接。你可以把这个链接发给任何人，对方会直接从你的电脑上拉取文件。
下载完成后还会继续做种吗？会的。默认情况下，下载完成的内容会自动继续做种，方便下一个人找到它们；你可以在「Seeding」标签页中暂停或停止任何项目，也可以为单个种子设置自定义的做种时长。
What are similar projects?qBittorrent, webtorrent-desktop, yoinks, rayburst, ink, gopeed, plexo, moji
Which topics is it in?crossplatform, magnet-links, zero-configuration, torrent, p2p, downloader, tui, command-line, react, privacy, terminal, nodejs
Creator
baairon
Size
0.3 MB
Stars
5.9K
Updated
CommitOct 15Releasev1.9.1Oct 10
Age
3mo
Commits · 90 Days