📘

qui

This application is currently offered as a BETA release. Beta applications are provided on an experimental basis and may be subject to change or removal from our service at any time without prior notice.

Official support is not available for beta applications. While you are welcome to test and use them, stability, performance, and long-term availability are not guaranteed. Use at your own risk.

qui

qui is a modern web interface for qBittorrent that enhances your torrenting experience with powerful features and an intuitive design.

Major features include:

Multi-Instance Management: Manage all your qBittorrent instances from one place
Cross-Seed: Automatically find and add matching torrents across trackers
Automations: Rule-based torrent management with conditions and actions
Backups: Scheduled snapshots with incremental and complete restore
Tracker Reannounce: Automatically fix stalled torrents
Orphan Scan: Find and remove files not associated with any torrent
Reverse Proxy: Let external apps access qBittorrent without credentials

This guide covers the installation and configuration of qui on your Ultra.cc service.

Initial Setup

After installation, connect qui to your qBittorrent instance.

Access qui from the Apps tab on the UCP.
Log in using your Ultra service username and the password you set during qui installation.

Add your qBittorrent instance using the following connection details:

Host: {username}.{servername}.usbx.me
Port: 443
URL Base: /qbittorrent
Password: As configured in UCP under qBittorrent
Use SSL: YES

Once added, verify that the instance shows Connected and that Local Filesystem Access is enabled. Local Filesystem Access is required for features like Orphan Scan and Hardlink cross-seeding.
If both indicators show green, the setup is complete.

Backups

qui can take scheduled or ad-hoc snapshots of a qBittorrent instance. Each snapshot includes the torrent archive, tags, categories (with save paths), and cached .torrent blobs to recreate the original state later.

Restores support three modes: Incremental (add missing items only), Overwrite (update existing items), and Complete (full sync with deletions). Every restore begins with a dry-run preview to inspect planned changes before applying them.

For configuration options, restore details, and backup imports, see the official qui documentation.

Tracker Reannounce

qui can automatically fix stalled torrents by reannouncing them to trackers. This helps when a tracker fails to register a new upload immediately, ensuring your torrents start seeding without manual intervention.

Enable Tracker Reannounce

Go to Services in the main navigation.
Select an instance from the dropdown.
In the Tracker Reannounce section, toggle Enabled to turn it on.
Click Save Changes.

For configuration options and advanced settings, see the official qui documentation.

Orphan Scan

The Orphan Scan feature finds and removes files in your download directories that are not associated with any torrent.

qui scans all unique SavePath directories from your current torrents. Files not referenced by any torrent are flagged as orphans. Review the list before confirming deletion. Empty directories are cleaned up after file removal.

Directories are only scanned if at least one torrent points to them. If you delete all torrents from a directory, that directory is no longer a scan root and any leftover files there will not be detected.

For configuration options and scheduled scans, see the official qui documentation.

Cross-Seeding

qui offers cross-seeding to automatically find and add matching torrents across trackers. For setup instructions and configuration options, refer to the official qui cross-seeding documentation.

Cross-seeding using any method other than Regular only works if the qui instance is local (same host) and can access the same paths. Both your qBittorrent and qui must be hosted with Ultra.cc for non-Regular methods to work.

Client Proxy

qui includes a built-in reverse proxy that allows external applications like autobrr, Sonarr, Radarr, and other tools to connect to your qBittorrent instances without needing qBittorrent credentials.

qui maintains a shared session with qBittorrent and proxies requests from your external apps. This eliminates repeated authentication attempts as automation tools reuse the live session instead of racing to re-authenticate.

Create a Client Proxy API Key

Go to Settings > Client Proxy Keys.
Click Create Client API Key.
Enter a name for the client (such as “Sonarr”).
Choose the qBittorrent instance you want to proxy.
Click Create Client API Key.
Copy the generated proxy URL immediately as it is only shown once.

Sonarr and Radarr

Go to Settings > Download Clients.
Click Show Advanced using the cog icon.
Add a new qBittorrent client.
Use the following connection details. Extract the path portion from your proxy URL (everything after the domain) and use it as the URL Base.

Host: {username}.{servername}.usbx.me
Port: 443
URL Base: /qui/proxy/YOUR_API_KEY
Password: Leave blank (authentication is handled by the proxy URL)
Use SSL: YES

Click Test and then Save once the test succeeds.

Autobrr

Go to Settings > Download Clients.
Add qBittorrent (or edit an existing one).
Use the following connection details. Paste your full qui Proxy URL as the Host.

Host: https://{username}.{servername}.usbx.me/qui/proxy/YOUR_API_KEY
TLS: Enabled
Username: Leave blank
Password: Leave blank

Click Test and then Save.

Automations

Automations are a rule-based engine that automatically applies actions to torrents based on conditions. Use them to manage speed limits, delete old torrents, organize with tags and categories, and more.

For setup instructions and available actions, see the official qui documentation.

Recommended Setup

To keep your instance clean without accidentally deleting files or breaking cross-seeds:

Remove Unregistered Torrents (Keep Files): Create a rule with the condition Is Unregistered is true and set the action to delete (not deleteWithFiles). This removes the torrent entry from qBittorrent but leaves the actual files intact.
Run Orphan Scans Regularly: After unregistered torrents are removed, their files become orphans. Use the Orphan Scan feature to find and manage these leftover files on your own schedule.

This approach prevents automations from deleting files directly, which avoids issues with cross-seeded content.

Custom Themes

Custom themes can be applied by supporting the developers. For more information, visit the qui support page.

Troubleshooting

qui is not loading or showing an error

Connect via SSH and run app-qui restart.
Ensure your qBittorrent instance is running and accessible.
Verify you are using the correct username and password set during qui installation.
Visit the User Control Panel, navigate to the Apps tab, find qui, and use the Upgrade & Repair option from the Actions menu.

Cross-seeding is not working

Verify that the method you selected is compatible with your setup.
If using the Hardlink method, ensure both qui and qBittorrent are on the same Ultra.cc service.
Check that the base path exists and has proper permissions.
Review the qui logs for specific error messages.

Reannounce is not fixing stalled torrents

Ensure Tracker Reannounce is enabled in Services.
Check the Activity Log for any errors.
Verify the torrent is within the Max Torrent Age window.

Orphan Scan is not finding expected files

Directories are only scanned if at least one torrent points to them.
Check if the files are within the grace period.
Verify the paths are not in the ignore list.

If you require further assistance, you can open a support ticket **here**!

Feedback and suggestions regarding this article are welcome on our **Discord server**

qui
Initial Setup
Backups
Tracker Reannounce
Enable Tracker Reannounce
Orphan Scan
Cross-Seeding
Client Proxy
Create a Client Proxy API Key
Sonarr and Radarr
Autobrr
Automations
Recommended Setup
Custom Themes
Troubleshooting