QBITTORRENT-NOX(1)

📦
version 5.3.0 · 6 versions
, in arch rolling, nixpkgs unstable

💖 QBITTORRENT-NOX(1) 💖

okay so first things first, this is a page from the General Commands Manual bestie, and the whole thing is about qbittorrent-nox — yes the name is giving lowercase-cursed but we love her anyway 🫶

✨ NAME ✨

qBittorrent-nox — a command line Bittorrent client written in C++ / Qt 💅

🎀 SYNOPSIS 🎀

qbittorrent-nox [options] [(<filename> | <url>)...]

qbittorrent-nox --help

qbittorrent-nox --version

like, you can pass options, you can pass files or urls, or you can just be nosy and ask for help/version. all iconic choices ✨

🌸 DESCRIPTION 🌸

qBittorrent-nox is an advanced command-line Bittorrent client, written in C++ / Qt and using the libtorrent-rasterbar library by Arvid Norberg. no cap, she aims to be a good alternative to other command line bittorrent clients, and she provides features similar to the popular graphical clients. main character energy fr fr 👑

she's fast, she's stable, she's light, and she supports Unicode 💜 also she comes with:

  • UPnP port forwarding / NAT-PMP
  • encryption (Vuze compatible)
  • FAST extension (mainline)
  • PeX support (utorrent compatible)

the way that she's meant to be controlled via her feature-rich Web UI 😭 which is accessible by default at http://localhost:8080. the default WebUI administrator user name is “admin”. and listen — if no password has been set, a temporary random password is generated and printed to the console on each startup, so you should set your own password in the program preferences. do not skip that step bestie, i'm begging 🙈

💅 OPTIONS 💅

  • -h | --help — display this help message and exit. cute, polite, done ✨
  • -v | --version — display program version and exit. identity check 🪞
  • --confirm-legal-notice — confirm the legal notice. the paperwork era 🎀
  • --webui-port=<port> — change the WebUI port.
  • --torrenting-port=<port> — change the torrenting port.
  • -d | --daemon — run in daemon-mode (background). she's leaving the group chat to go do her own thing 💀
  • --profile=<dir> — store configuration files in <dir>.
  • --configuration=<name> — store configuration files in directories qBittorrent_<name>.
  • --relative-fastresume — hack into libtorrent fastresume files and make file paths relative to the profile directory. it's literally called a hack in the manpage, so like… proceed with that knowledge 👀
  • (<filename> | <url>)... — download the torrents passed by the user. feed her 🍓

🦋 Options when adding new torrents 🦋

  • --save-path=<path> — torrent save path.
  • --add-stopped=<true|false> — add torrents as running or stopped. vibe check: running or paused 💅
  • --seed-mode — seed mode. she's not here to download, she's here to give 🌈
  • --category=<name> — assign torrents to category. if the category doesn't exist, it will be created — she's proactive like that ✨
  • --sequential — download files in sequential order. one at a time, no chaos 🎀
  • --first-and-last — download first and last pieces first. edge pieces first, iconique 🫶
  • --skip-dialog=<true|false> — specify whether the “Add New Torrent” dialog opens when adding a torrent.

🧚 ENVIRONMENT 🧚

okay so this is lowkey the best part: option values may be supplied via environment variables 💖 for an option named parameter-name, the environment variable name is QBT_PARAMETER_NAME (upper case, with - replaced by _).

to pass flag values, set the variable to 1 or TRUE. for example, to change the WebUI port:

QBT_WEBUI_PORT=8081 qbittorrent-nox

and important: command line parameters take precedence over environment variables. the command line is the main character here, the env vars are the supporting cast 👑

😭 BUGS 😭

if you find a bug, please report it at https://bugs.qbittorrent.org — she wants to know, she's not mad, she just wants to grow 🥺

⭐ AUTHORS ⭐

Christophe Dumez chris@qbittorrent.org. thank you for your service king 🫡💜

fr fr that's the whole page, no skips, no cuts 💖 now go set an actual password before you get got 🙈

and that's the wrap bestie — this was Command line Bittorrent client... version August 2026 of the QBITTORRENT-NOX(1) manual page, sealed with a kiss 🎀💋 slay, you read the whole thing, i'm so proud 🥹✨

📦 where this page comes from