magnetfinder

KO | EN

gitlite — search

#java #python #php #dsh-plugin #deepseek-harness #c-plus-plus #http-client #hacktoberfest #android #demo #game #dsh

★ 68 Open GitHub ↗

Multi-threaded CLI torrent scraper for displaying searched for magnet links; tailored for use with plex & ssh.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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

Supported torrent client for autodownloads:
- deluge-console
- transmission-cli
- qbittorrent-cli (*[GitHub](https://github.com/ludviglundgren/qbittorrent-cli))

![](https://i.imgur.com/piuGz7w.png)

## 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 macOS

## Installation
First install rust if you haven't already: https://www.rust-lang.org/tools/install

From Cargo/Crate: ```cargo install magnetfinder```

From Source: 
- ```git clone https://github.com/bleusakura/magnetfinder.git``` then ```cargo build --release```
- After building, the binary will be located in ```./target/release/```, which can then be moved elsewhere.

You can also decide to skip compiling and download a binary from the [releases section](https://github.com/bleusakura/magnetfinder/releases)

magnetfinder

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README