qbittorrent-cli

Manage qBittorrent from the command line.

qbt is a small, fast command-line tool to manage qBittorrent over its Web API. It is handy for automation (autodl-irssi, cron jobs), bulk operations and migrating from other clients.

Add torrents

Add from file, glob pattern, URL or magnet - with categories, tags, save paths and rate limits. qbt torrent add

Reannounce

Reannounce torrents with non-OK tracker status to get past troublesome trackers. qbt torrent reannounce

Import from other clients

Bring torrents and their state over from Deluge and rTorrent. qbt torrent import

Categories & tags

Create, edit and manage categories and tags, and move torrents between them. qbt category · qbt tag

Quick start

# Install (see the Installation guide for all options)
go install github.com/ludviglundgren/qbittorrent-cli/cmd/qbt@latest

# Point it at your qBittorrent Web API
mkdir -p ~/.config/qbt && $EDITOR ~/.config/qbt/.qbt.toml

# Add a torrent
qbt torrent add my-file.torrent --category linux-iso --tags iso

See the Installation and Configuration guides to get set up, then browse the full command reference.