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, never seeding back out. The files are yours, saved to your downloads folder.
## Get started
1. **Install Node.** It's a free tool from [nodejs.org](https://nodejs.org), the one thing torlink runs on.
2. **Open your terminal.**
3. **Run torlink:**
```sh
npx torlink
```
That's it, nothing else to install. Once it's open you can paste a magnet link straight into the search box, or just press Enter while it's empty to browse the curated library. You can also start from the command line:
```sh
npx torlink "magnet:?xt=..." # start from a magnet link
npx torlink "" # open a .torrent file
npm install -g torlink # install for good, then run: torlink
```
## 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.
## 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.
## What it searches
A short, hand-picked list of trusted sources:
| 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. If a source is down, the search carries on without it, 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:
```sh
npm install
```
3. Run the development version:
```sh
npm run dev
```
Or build it and run the bundled version:
```sh
npm run build
npx torlink
```
## Star History
