Why it is worth attention

It uniquely folds duplicate torrents from multiple indexes into a single row with combined tracker lists, offers a built-in official Linux ISO browser, and provides a strict proxy mode with Tor integration, all within a calm terminal interface.

Who it is for

Torrent users who prefer command-line tools
Linux users seeking a simple way to download official ISOs
Privacy-conscious users who want a proxy-integrated torrent client
Terminal enthusiasts looking for a feature-rich TUI application

Use cases

Searching and downloading torrents from multiple indexes with deduplication
Browsing and grabbing official Linux ISOs (Ubuntu, Debian, Fedora, etc.)
Managing downloads (pause, verify, seed, move) via keyboard-driven TUI
Routing all torrent traffic through SOCKS5 proxy (e.g., Tor) for privacy

Strengths

Deduplicates torrents across indexes and combines tracker lists for better availability
Integrated proxy mode with strict isolation (disables DHT, uTP, inbound peers) and Tor exit verification
Built-in health checks and swarm compass for monitoring provider and download health
One-key retrieval of official Linux ISOs without hunting for mirrors

Considerations

Autopilot feature is marked as work-in-progress
Proxy strict mode may result in fewer peers and slower downloads
Requires Go 1.26+ and compilation for platforms without prebuilt binaries

README quick start

tork

 /\_/\
( ^.^ )  a cozy terminal for torrent search + one-key linux isos
 > ^ 20 size:<8gb
linux codec:x265 -source:cam
provider:nyaa category:anime is:trusted
is:hdr -is:dv

Available fields are res, seeders, size, source, codec, provider, and category. Attributes include is:trusted, is:hdr, is:dv, and is:pack; prefix any structured filter with - to negate it.

Verification rehashes completed torrent pieces. Direct downloads require a published SHA256; mismatches are moved aside as .corrupt, .corrupt.1, and so on before retrying.

Autopilot (WIP)

Describe what you want and let the cat make a plan:

tork autopilot "all breaking bad seasons 1080p under 40GB"
tork autopilot --dry-run --min-seeders 20 "dune 2024 2160p"

Autopilot shows its picks, total known size, reasons, and a summary of rejected results before asking to queue anything. Use -n N to cap the picks, --max-size 8GB to cap each download, or --category movies,anime to narrow provider categories. When the same limit appears in several places, the flag wins over the request text, which wins over config defaults. --headless skips the TUI but still asks before queuing; scripts and cron jobs need --yes. Decisions stay local in ~/.tork/autopilot.jsonl so a strange choice can be inspected later.

Persistent defaults can live under autopilot in ~/.tork/config.yaml:

autopilot:
  max_downloads: 3
  min_seeders: 10
  max_size_gb: 40
  allowed_categories: [movies, anime]

Legal

tork is a BitTorrent client and search tool. It does not host files, operate trackers, or control the third-party providers it can search.

Use it only for content you are allowed to download and share, such as official Linux ISOs, public-domain media, open-source software, and your own files. You are responsible for following local law and the terms of any provider you enable.

Provider availability and results can change without notice. tork does not endorse or guarantee third-party content.

A proxy routes tork's traffic, but it is not a promise of anonymity or legal protection.

MIT, see LICENSE.

Description

cli for searching and downloading torrents

Related repositories

Similar projects matched by category, topics, and programming language.

nethical6

Featured

conversation-steganography

A tool that hides encrypted secret messages inside innocent-looking AI-generated chat text for private communication over any messaging platform.

1,149

programmersd21

Featured

flow

flow is a minimalist terminal dashboard that displays real-time network throughput with smooth animations, multiple responsive modes, and zero configuration.

Developer ToolsCLI & Terminal

277

MobAI-App

simslim

simslim reduces iOS simulator memory usage by 4x by disabling unnecessary background daemons, allowing many more simulators to run on a single Mac.

248