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!