torlink/README.md

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. It's a free tool from nodejs.org, the one thing torlink runs on.

2. Open your terminal.

3. Run torlink:

   npx torlink
   

That's it, nothing else to install. Once it's open you can paste a magnet link straight into the search box. You can also start from the command line:

npx torlink "magnet:?xt=..."   # start from a magnet link
npx torlink ./file.torrent     # open a .torrent file
npm install -g torlink         # install for good, then run: torlink

What it does

• One search, every source. Type once and torlink checks them all together, showing each result's size and how many people are sharing it.
• Curated, not a free-for-all. A small, vetted set of sources, tagged so you always know where a result came from.
• Downloads only, never seeds. Files come to your computer and stop there. torlink never sends them back out.
• Nothing to configure. It opens straight to a search box, ready the moment it starts.

Finding something

Type what you're looking for and press Enter. torlink checks every source at once, and results show up as each one answers, so you're never stuck waiting on a slow one. Each result lists its size and how many people are sharing it, so you can see which one will come down fast. Arrow to the one you want, press d, and it saves to your downloads folder. Leave the box empty and press Enter to just see what's new across every source.

Your downloads

Your active downloads and the stuff you've already grabbed share one pane. Whatever's still coming down sits up top with its progress, speed, and time left. When a file finishes it drops into Recently downloaded just below, so the list stays tidy instead of piling up. Anything there is one key from downloading again, and it's all still waiting when you come back, resuming anything that got interrupted.

What it searches

A short, hand-picked set instead of a directory of unknowns:

Category	Sources
Games	FitGirl
Movies	YTS, The Pirate Bay, 1337x
TV	EZTV, SolidTorrents, The Pirate Bay, 1337x
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. A source being down never stops a search, the others keep going and torlink tells you which one is offline.

Local Development

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 torlink
   

Star History