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. See here.
  • qBittorrent instance installed on your service.

Installation

  • Connect to your Ultra.cc service via SSH
  • Clone the qBit Manage repo to the .apps directory by executing the following command:
git clone https://github.com/StuffAnThings/qbit_manage ~/.apps/qbit_manage
  • Navigate into the cloned repo directory.
cd ~/.apps/qbit_manage
  • Next, install the required Python packages.
    • If you encounter issues with the following command, add --ignore-installed at the end of the command.
pip install -r requirements.txt
  • Create a qBit Manage configuration file by copying config.yml.sample
cp ~/.apps/qbit_manage/config/config.yml.sample ~/.apps/qbit_manage/config/config.yml
  • 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:
python ~/.apps/qbit_manage/qbit_manage.py -h
  • Done!

Uninstallation

  • Uninstalling qBit Manage is easily done by deleting the app directory:
rm -rf ~/.apps/qbit_manage
  • Done!