Skip to main content

qBit Manage

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.

qBit Manage is a tool to manage your qBittorrent instance from the CLI. Included features are change tag, categories, remove unregistered torrents, and a lot more.

  • More information can be found here.

Prerequisites

  • Python version 3.8.1 or above (will be installed by script).
  • qBittorrent instance installed on your service.

Installation

  • Connect to your Ultra.cc service via SSH
  • Once connected, execute the following command:
bash <(wget -qO- https://scripts.ultra.cc/main-v2/qBit-Manage/main.sh)
  • Type 1 and confirm with ENTER to proceed with the installation
  • Wait for the installation to finish
  • Confirm the installation was successful by executing the following command:
python ~/.apps/qbit_manage/qbit_manage.py -h
  • If successful, your terminal will output usage instructions for qBit Manage.

Configuration

Once qBit Manage has been installed, you need to edit the configuration file with your qBittorrent connection details. Look at the output of the install script to see the qBit Manage configuration file path.

  • Open the configuration file with the editor.
    • Find the qbt: section and add your qBittorrent connection details, which can be found on the UCP.
nano ~/.apps/qbit_manage/config/config.yml
  • Do note that the configuration file is just a template, and needs to be configured to match your specific setup., refer to qBit Manage documentation for more information.
  • Once you have made your changes, press ctrl+x and y to save your changes and exit. Press ENTER to confirm.
  • Confirm the installation was successful by executing the following command:
    • The -h option stands for help, and will print the help message.
python ~/.apps/qbit_manage/qbit_manage.py -h
  • Done!

Uninstallation

  • Uninstalling qBit Manage is easily done by deleting the app directory:
bash <(wget -qO- https://scripts.ultra.cc/main-v2/qBit-Manage/main.sh)
  • Type 2 and confirm with ENTER to proceed with the uninstallation
  • Done!