QBITTORRENT(1)

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

👑 qBittorrent(1) — like, the manual, bestie ✨

okay so this is from the General Commands Manual section of your friendly neighborhood man pages, and it's about to be your new favorite thing. sit down, grab a boba, let's go 🧋💖

🌸 NAME 🌸

qBittorrent — a Bittorrent client written in C++ / Qt. that's it, that's the vibe. no cap. 💅

🦋 SYNOPSIS 🦋

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

qbittorrent --help

qbittorrent --version

literally just run it, optionally throw some torrent files or URLs at it, and she works. iconic behavior tbh 🎀

✨ DESCRIPTION ✨

So qBittorrent is an advanced Bittorrent client written in C++ / Qt, and it's built on top of the libtorrent-rasterbar library by Arvid Norberg. highkey a power couple 🫶

It's similar to uTorrent — you know, that one — but make it cute. qBittorrent is fast, stable, light, it supports Unicode, and it gives you a genuinely good integrated search engine. obsessed. 🔥

It also ships with:

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

like... she does it all. main character energy fr fr 👑

💅 OPTIONS 💅

  • -h | --help — shows you this help message and dips out. very "bye, love you" of her. 🩷
  • -v | --version — spits out the program version and exits. quick little flex.
  • --confirm-legal-notice — confirms the legal notice. yes bestie, the paperwork. 📄
  • --webui-port=<port> — changes the WebUI port. that's the port number, don't @ me. 🌐
  • --torrenting-port=<port> — changes the torrenting port. different port, same slay. 🔌
  • --no-splash — disables the splash screen. no waiting, straight to business. 💨
  • --profile=<dir> — stores configuration files in <dir>. your setup, your rules. 📁
  • --configuration=<name> — stores configuration files in directories named qBittorrent_<name>. spreadsheet girlies rise 🌸
  • --relative-fastresume — a straight-up hack into libtorrent fastresume files that makes the file paths relative to the profile directory. yes, it's a hack, it says so, we love a self-aware legend. ⚠️✨
  • (<filename> | <url>)... — downloads the torrents passed by the user. feed her. 🍓

🎀 Options when adding new torrents 🎀

like, specifically for the "new torrent, who dis" moment:

  • --save-path=<path> — torrent save path. where it lives now. 🏡
  • --add-stopped=<true|false> — adds torrents as running or stopped. your call, bestie.
  • --seed-mode — seed mode. that's it. that's the whole thing. 🌱
  • --category=<name> — assigns torrents to a category. and listen — if the category doesn't exist, it will be created. she's proactive like that. 💖
  • --sequential — downloads files in sequential order. one at a time, in order, no chaos. 📚
  • --first-and-last — downloads the first and last pieces first. prioritize the edges, iykyk. 🦋
  • --skip-dialog=<true|false> — specifies whether the "Add New Torrent" dialog opens when adding a torrent. sometimes you just don't wanna be perceived. 🙈

🌈 ENVIRONMENT 🌈

Big one — option values may be supplied via environment variables. 🫶

Here's the formula, and it's honestly so clean: for an option named parameter-name, the environment variable name is QBT_PARAMETER_NAME — that's upper case, with - replaced by _.

To pass flag values, set the variable to 1 or TRUE. for example, to disable the splash screen:

QBT_NO_SPLASH=1 qbittorrent

And the golden rule: command line parameters take precedence over environment variables. the CLI is the main character here, periodt. 👑

💀 BUGS 💀

If you find a bug, please report it at https://bugs.qbittorrent.org. don't suffer in silence, tell the devs, they wanna know. 🐛

🌟 AUTHORS 🌟

Christophe Dumez chris@qbittorrent.org. king behavior. 👑💜

that's the whole page, you're welcome, go download something legally and responsibly 🧚💖

— signed, sealed, delivered by whoever wrote Bittorrent client written in C... · August 2026 · QBITTORRENT(1) ⭐🎀

📦 where this page comes from