mirror of
https://github.com/baairon/torlink.git
synced 2026-07-08 18:28:22 +02:00
TechNapoleonandGitHub
28565a88dd
The o key sets one global download folder, so routing a single result somewhere else (a movie to the NAS, a game to the big drive) meant changing the setting and changing it back. D on a result now opens a "download to" prompt for just that item; d stays a one-keypress download to the default. The queue already stores a dir per item, so resume, re-seed and download-again honor the choice with no new plumbing. The prompt reuses FolderPrompt (new title prop), pre-fills with the last D folder this session so batches cost one typed path, and nothing new is persisted. The ? sheet gains d/D entries (d was missing entirely) and the README now mentions both o and D, which it never documented. One behavior fix rides along because D exposed it: queue.add() used to ignore the requested dir when re-adding a failed item, so redirecting a failed download (the disk-full case D exists for) silently retried into the old folder. add() now adopts the requested dir on failed retry, dropping resume progress only when the folder actually changed; covered in queue.add.test.ts with the engine mocked. The f retry key goes through queue.retry() and keeps the item's own folder, unchanged. D on an already-active item says "Already in queue" instead of claiming a folder that wouldn't be used.
86 lines
4.5 KiB
Markdown
86 lines
4.5 KiB
Markdown
<p align="center">
|
|
<img src="preview/splash.svg" alt="torlink, curated torrents straight from your terminal" style="max-width: 832px; width: 100%; height: auto;">
|
|
</p>
|
|
|
|
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](https://nodejs.org)), it's all torlink needs.
|
|
2. **Open your terminal.**
|
|
3. **Start it:**
|
|
|
|
```sh
|
|
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, 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 `D` to pick a different folder for just that download.
|
|
|
|
<p align="center">
|
|
<img src="preview/browse.svg" alt="torlink's browse view: the sidebar, the search bar, and merged results from every source" style="max-width: 832px; width: 100%; height: auto;">
|
|
</p>
|
|
|
|
## 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 — press `o` anytime to change where that is, or grab one result with `D` to send it somewhere else without touching the default — and the Downloads pane keeps tabs on each one. 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.
|
|
|
|
<p align="center">
|
|
<img src="preview/downloads.svg" alt="torlink's Downloads pane: live progress on top, recently downloaded below" style="max-width: 832px; width: 100%; height: auto;">
|
|
</p>
|
|
|
|
## What it searches
|
|
|
|
A short, hand-picked list of trusted sources:
|
|
|
|
| Category | Sources |
|
|
| --- | --- |
|
|
| Games | FitGirl |
|
|
| Movies | YTS, The Pirate Bay, 1337x |
|
|
| TV | EZTV, 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.
|
|
|
|
## Contributing
|
|
|
|
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 torlnk
|
|
```
|
|
|
|
Before opening a PR, skim [CONTRIBUTING.md](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.
|
|
|
|
## Star History
|
|
|
|
<a href="https://www.star-history.com/?repos=baairon%2Ftorlink&type=date&legend=top-left">
|
|
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=baairon/torlink&type=date&theme=dark&legend=top-left" />
|
|
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=baairon/torlink&type=date&legend=top-left" />
|
|
<img alt="Star History Chart" src="https://api.star-history.com/chart?repos=baairon/torlink&type=date&legend=top-left" />
|
|
</picture>
|
|
</a>
|