Multi-threaded CLI torrent scraper for displaying searched for magnet links; tailored for use with plex & ssh.
Last updated May 13, 2026
68
Stars
4
Forks
3
Issues
0
Stars/day
Attention Score
12
Topics
Language breakdown
No language data available.
โธ Files
click to expand
README
magnetfinder
Multi-threaded CLI torrent aggregator; scrapes torrent results from multiple websites and delivers them into a table in your terminal!Supported Websites:
- nyaa
- piratebay
- YTS
- deluge-console
- transmission-cli
- qbittorrent-cli (*GitHub)
Usage
Running magnetfinder without any arguments will launch interactive mode, prompting for similar information set by flags.
Flags/Arguments
-q, --query <query> search query to use-n, --nyaa scrape nyaa for torrents-p, --piratebay scrape piratebay for torrents-y, --yts get torrents from YIFY/YTS-a, --all scrape all available websites together-d, --download autodownload the torrent(s) selected--depth <depth> specifies how many pages to search through for each website, default is 1--dir <directory> directory to download torrent if autodownload was toggled--sort <seeds/size> allows you to specifiy if the torrent table is sorted by seeders or size--proxy <proxy url> allows you to set a proxy to use when making web requests to torrent websites & api--show <num> truncate list of torrents displayed by the number argument given--no-interactive displays all torrents with magnet directly without interacting (--show is useful here)
Configuration
Settings.toml (for setting default behavior, such as download directories & autodownload) is located in an OS specific directory:
~/.config/magnetfinder/ on Linux/AppData/Roaming/magnetfinder on Windows/Library/Application Support/magnetfinder/ on macOSInstallation
First install rust if you haven't already: https://www.rust-lang.org/tools/installFrom Cargo/Crate:
install magnetfinderFrom Source:
thenclone https://github.com/bleusakura/magnetfinder.gitbuild --release- After building, the binary will be located in
, which can then be moved elsewhere../target/release/
๐ More in this category