All apps/qBittorrent CLI

qBittorrent CLI

qbittorrent-cli

Command-line interface to manage qBittorrent.

Runs as qbt|macOS, Linux, Windows|github.com

Command form

ai-draft · 4 tasks · 14 fields

Add torrents and list torrents in a running qBittorrent. Connection settings come from the config file.

Opens the form; the finished command lands at your prompt, unrun
otty gui qbittorrent-cli

qbt torrent add

Add torrents

Add torrent files or magnet links. Glob patterns work for files.

Add torrentsExample values, fixed in this page — nothing here reaches a terminal
Basic
Torrent files or magnet links*
string
Category
string
Tags
string
Save path
directory
Add paused
--paused
TasksEach one presets the form for one job
Add torrents
sourcescategorytagssave_pathpaused
Add paused, skip hash check
sourcespausedskip_hash_checkcategory
ParametersOnly these flags are editable in the form
Torrent files or magnet links
string · positional 0 · repeatable
Category
string
--category
Tags
string · repeatable
--tags
Save path
path
--save-path
Add paused
boolean
--paused
Skip hash check
boolean
--skip-hash-check
Sequential download
boolean
--sequential
Dry run
boolean
--dry-run
Quiet
boolean
--quiet-q

qbt torrent list

List torrents

List torrents, filtered by state, category, tag or hashes.

List torrentsExample values, fixed in this page — nothing here reaches a terminal
Basic
State filter
12 choicesenum
Category
string
Tag
string
TasksEach one presets the form for one job
List by state
filtercategorytag
List as JSON
filtercategorytaghashesoutput
ParametersOnly these flags are editable in the form
State filter
enum
--filter-falldownloadingseedingcompletedpausedactiveinactiveresumedstalledstalled_uploadingstalled_downloadingerrored
Category
string
--category-c
Tag
string
--tag-t
Hashes
Comma-separated: hash1,hash2.
string
--hashes
Output format
enum
--outputjson
SourcesEvery flag above is checked against these
help
Add new torrent(s) to qBittorrent from file or magnet. Supports glob pattern for files like: ./files/*.torrent qbt torrent add [flags] qbt torrent add my-file.torrent --category test --tags tag1 qbt torrent add ./files/*.torrent --paused --skip-hash-check qbt torrent add magnet:?xt=urn:btih:5dee65101db281ac9c46344cd6b175cdcad53426&dn=download --c…
help2026-10-27

ludviglundgren.github.io

help
qbt torrent list [flags] qbt torrent list --filter=downloading --category=linux-iso -c, --category string Filter by category. All categories by default. -f, --filter string Filter by state. Available filters: all, downloading, seeding, completed, paused, active, inactive, resumed, stalled, stalled_uploading, stalled_downlo…
help2026-10-27

ludviglundgren.github.io

Before it fills your prompt, Otty checks the installed qbt against its version. A form that does not match your version is not offered.