Skip to main content

qbittorrent-cli

This unofficial app installation guide is provided for your convenience. The guide is provided as-is and may not be updated or maintained by Ultra.cc. Unofficial support may be offered via Discord only and at the sole discretion of Ultra.cc staff. Use at your own risk and only proceed if you are comfortable managing the application on your own.

qbittorrent-cli is a feature rich CLI to manage qBittorrent. It provides features such as; Add torrents, categories, tags, reannounce and import torrent sessions from other clients.

  • More information can be found here.

Installation

  • Go here and find the latest binary filename that ends in linux_amd64.tar.gz and copy its URL.
    • For this guide, we will use this URL as an example: https://github.com/ludviglundgren/qbittorrent-cli/releases/download/v2.0.0/qbittorrent-cli_2.0.0_linux_amd64.tar.gz
  • Connect to your Ultra.cc service via SSH
  • Execute the following command (changing the URL to the one copied from GitHub):
curl -LO https://github.com/ludviglundgren/qbittorrent-cli/releases/download/v2.0.0/qbittorrent-cli_2.0.0_linux_amd64.tar.gz
  • Next, we will extract the binary.
    • The filename may be different if you have downloaded a newer version.
tar -xzvf qbittorrent-cli_2.0.0_linux_amd64.tar.gz
  • Next, we will move the binary into $PATH, allowing it to be globally executable. And also remove some unnecessary files left from the installation.
mv qbt ~/bin/ && rm -v qbittorrent-cli_2.0.0_linux_amd64.tar.gz LICENSE README.md
  • Verify it has been installed by executing:
qbt
  • Next, we need to create a bare minimum configuration file. To do so, execute the following command:
mkdir -p ~/.config/qbt && touch ~/.config/qbt/.qbt.toml
  • Open the configuration file with the nano editor by executing the following command:
nano ~/.config/qbt/.qbt.toml
  • Paste the below text into the configuration file.
[qbittorrent]
addr       = "http://127.0.0.1:<WEBUI-PORT>" # qbittorrent webui-api hostname/ip
login      = "username"                     # qbittorrent webui-api user
password   = "XXXXXXXXXXXXXXX"              # qbittorrent webui-api password

[rules]
enabled              = true   # enable or disable rules
max_active_downloads = 2      # set max active downloads

  • Make sure to edit port, login and password with your specific details, which can be found on the UCP.

  • Once you have made the necessary changes to the configuration file, save and exit by pressing CTRL+x and y, press ENTER to confirm.

  • Done!

Usage

  • Print usage instructions: qbt help
  • Print command specific usage instructions: qbt torrent import help

qbittorrent-cli can do a lot of things. For example, to import your Deluge torrent session into qBittorrent, see the below command. You can do a test run of the command by appending --dry-run to the command.

qbt torrent import deluge --source-dir ~/.config/deluge/state/ --qbit-dir ~/.local/share/qBittorrent/BT_backup/

Uninstallation

  • Uninstalling qbittorrent-cli is easily done by removing the binary:
rm -v ~/bin/qbt
  • Done!
Back to top