qbtrs

A qbittorrent cli client focused on ease of use and simplicity.

Currently, qbtrs only supports managing torrents, not other things like categories or tags.

Getting started

First, either compile the program yourself or aquire a binary release.

Adding a url

After that, start by running the auth add command to authenticate your qbittorrent instance. You will be prompted to enter your password. Alternatively, pass --password <YOUR PASSWORD> to specify it directly.

qbtrs auth add http://example.com:8080 username

NOTE: If this fails, you won't be getting any helpful error messages because the qbittorrent API does not return anything useful

Listing all torrents

Now that you have authenticated to your instance, you can run torrent list to get a list of all torrents in your instance.

You can use flags like --sort to sort the output by things like added-on or size

qbtrs torrent list

Adding a torrent

Adding a torrent is also very easy. Just run torrent add and provide either a path to a torrent file or a magnet link.

qbtrs torrent add path/to/torrent.torrent

NOTE: When passing a magnet link, pass it in quotes to avoid the shell messing with it.

Building

Building qbtrs is very simple. You just need a rust toolchain installed, which you can get from rustup.rs

After that, clone the repo and run cargo build --release

git clone https://github.com/PotatoMaaan/qbtrs.git
cd qbtrs
cargo build --release

Some notes

• I have not tested this on windows and macOS, I would expect it to work there as well Tested on windows, no idea about macOS
• All commannds are documented in the --help option.
• The code is full of unwraps right now, but im not really sure that implementing "proper" erorr handling would make any meaningful difference to the user