gotorrent

README

gotorrent

TUI for searching torrents. You can open a torrent's magnet link in your default app, or download its .torrent file. This app does not handle leeching/seeding a torrent.

Currently queries ThePirateBay's API.

https://user-images.githubusercontent.com/7772501/180335527-d8a9678f-8e61-429d-bbc3-1a085884059d.mp4

Installation

go install github.com/ismaelpadilla/gotorrent@latest

Alternatively, you can clone the repo:

git clone https://github.com/ismaelpadilla/gotorrent
cd gotorrent
go install

Usage:

gotorrent <query>

Keybinds

• up/k: Scroll up.
• down/j: Scroll down.
• Enter: Navigate to a selected torrent.
• t: Download .torrent file.
• c: Copy magnet link to clipboard.
• d: See torrent description.
• f: See torrent files.
• s: Enter a new search query.
• q: Quit.
• ?: Expand/minimize help.

Flags

  -d, --debug                    show debug information
  -f, --download-folder string   folder where files are downloaded
  -h, --help                     help for gotorrent
  -p, --persist                  keep gotorrent open after selecting torrent

Input a number and press enter to navigate to that torrent's magnet link. Or use the up and down (or j/k) keys to navigate.

Configuration

A configuration file can be used, but flags take precedence over configuration.

Location

A config file can be put in the following locations:

• Same folder as the executable.
• $HOME/.config/gotorrent/.

Config keys

Only one configuration key can be set:

download-folder: Same as the --download-folder flag.

Configuration file example

download-folder = "/home/myUser/torrent"

Roadmap

The progress towards the first release can be tracked in the v0.1.0 milestone. At this point, all necessary work is done.