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
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.
- If you encounter issues with the following command, add
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
andy
to save your changes and exit. PressENTER
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!