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.above See(will herebe installed by script).
  • qBittorrent instance installed on your service.

Installation

Do note, qBit Manage is only compatible with qBittorrent versions up to 4.6.2. It is currently not working with the latest qBittorrent version 4.6.3.

  • Connect to your Ultra.cc service via SSH
  • CloneOnce connected, execute the qBitfollowing Managecommand:
  • repo
bash <(wget -qO- https://scripts.usbx.me/main-v2/qBit-Manage/main.sh)
  • Type 1 and confirm with ENTER to proceed with the .appsinstallation
  • directory
  • Wait for the installation to finish
  • Confirm the installation was successful by executing the following command:
git clone https://github.com/StuffAnThings/qbit_managepython ~/.apps/qbit_manageqbit_manage/qbit_manage.py -h
  • NavigateIf intosuccessful, theyour clonedterminal repowill directory.output usage instructions for qBit Manage.
cd

Configuration

~/.apps/qbit_manage

Once

qBit
    Manage
  • Next,has installbeen installed, you need to edit the requiredconfiguration Python packages.
    • If you encounter issuesfile with theyour followingqBittorrent command,connection adddetails. --ignore-installedLook at the endoutput of the command.
pip install -rscript requirements.txtto 
see
  • Create athe qBit Manage configuration file by copying config.yml.sample
cp ~/.apps/qbit_manage/config/config.yml.sample ~/.apps/qbit_manage/config/config.yml
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:
rmbash <(wget -rfqO- ~https:/.apps/qbit_manage/scripts.usbx.me/main-v2/qBit-Manage/main.sh)
  • Type 2 and confirm with ENTER to proceed with the uninstallation
  • Done!