feat: add qui-xseed.sh for qui-based cross-seed triggering

Replaces the legacy xseed.sh (removed in v4.0.0) with a qui-native
implementation that triggers data-based cross-seed searches via the
qui API when Radarr or Sonarr completes an import.

Key changes:
- Only ERROR/WARNING written to stderr (starr captures stderr as
  error-level logs, causing noisy notifications for INFO lines)
- Creates dir-scan entry, triggers scan, polls for completion
- Idempotent via ID log file (duplicate download IDs skipped)
- Updated README with full configuration documentation

Author: bakerboy448

.env.sample

@@ -1,20 +1,35 @@
 # .env
-# Environment Configuration StarrScripts Sample 2024-04
-# Rename this file to .env and fill in the values accordingly.
-# Xseed
-## Download Client Names
+# Environment Configuration StarrScripts
+# qui-xseed
+
+## Download Client Names (as named in Radarr/Sonarr Settings > Download Clients)
 ### For multiple clients, use format: "client1,client2,client3"
 ### Do not include extra spaces around commas!
-TORRENT_CLIENTS="" # Examples: "Qbit", "Qbit,Deluge"
+TORRENT_CLIENTS="" # Examples: "qBittorrent", "qBittorrent,Deluge"
 USENET_CLIENTS=""  # Examples: "SABnzbd", "SABnzbd,SABnzbd Anime"
-## Cross Seed API configuration
-XSEED_HOST="" # Example: "crossseed"
-XSEED_PORT="" # Example: "2468"
-## API Key for Cross Seed, if applicable
-XSEED_APIKEY="" # Example: "your-api-key"
-## Path to store the script's database of prior searches
-LOG_FILE=""   # Example: "/config/xseed_db.log"
-LOGID_FILE="" # Example: "/config/xseed-id.log"
+
+## qui API configuration (container name and port)
+QUI_HOST="" # Example: "qui"
+QUI_PORT="" # Example: "7476"
+
+## API Key for qui
+QUI_APIKEY="" # Example: "your-api-key"
+
+## Target Instance ID (from qui dashboard URL)
+QUI_TARGET_INSTANCE_ID="" # Example: "1"
+
+## qBittorrent Path Prefix (optional)
+# If arr apps and qBittorrent have different path mappings, specify
+# the prefix from qBittorrent's perspective here. Leave empty if
+# qui/qBittorrent and the arrs share the same file paths.
+QUI_QBIT_PATH_PREFIX="" # Example: "/data/downloads"
+
+## qBittorrent Tags (optional, comma-separated)
+QUI_TAGS="" # Example: "cross-seed,qui-inject"
+
+## Log paths (empty = defaults to script directory)
+LOG_FILE=""
+LOGID_FILE=""
 # ZFS Destory
 VERBOSE=0
 MAX_FREQ=2

README.md

@@ -11,40 +11,34 @@ error.
 
 ## Scripts Overview
 
-### Cross-Seed Category Filter for Qbittorrent
+### qui Cross-Seed Trigger for Starr Apps
 
-> This script has been removed and is no longer supported as part of Bakerboy448's v4.0.0 purge.
-> Please see the [v4.0.0 Release Notes](https://github.com/bakerboy448/StarrScripts/releases/tag/v4.0.0)
-
--   **Script:** `xseed_qbit_cat_filter.sh`
--   **Description:** Filters cross-seed requests by categories or trackers for execution by Qbittorrent.
--   **Instructions:** Open the file in a text editor and modify the variable definitions at the top of the script, then replace the "Execute on completion" command in qBittorrent with the one given in the notes at the top of the script.
--   **Creator:** [zakkarry](https://github.com/zakkarry)
--   **Usage:** Execute the script to filter categories or trackers as needed in Qbittorrent setups.
-
-### Cross-Seed Trigger for Starr Apps
-
-> This script has been removed and is no longer supported.
-> Please see the [v4.0.0 Release Notes](https://github.com/bakerboy448/StarrScripts/releases/tag/v4.0.0)
-
--   **Script:** `xseed.sh`
--   **Description:** Triggers a cross-seed search post-import or post-upgrade in Starr applications.
--   **Creator:** [Bakerboy448](https://github.com/bakerboy448/) with assistance and many improvements from [zakkarry](https://github.com/zakkarry)
--   **Instructions**
-    1. If using environmental variables file, copy `.env.sample` to `.env`.
-    2. If not using `.env`, open the script in a text editor and modify the required values under "# Xseed" header.
-    3. Ensure that your download client's _NAME_ in the Download Client section of the respective \*arr match the variables in the script.
-    4. Docker Users: Mount `.env` and `xseed.sh` to your Starr's `/config` mount.
-    5. In your \*arr, navigate to `Settings` -> `Connect` and add a "Custom Script" for the "On Import Complete" for Sonarr and "On File Import" and "On File Upgrade" for Radarr.
-    6. Test and Save.
-
-### Cross-Seed Updater
-
-> This script has been removed and is no longer supported.
-> Please see the [v4.0.0 Release Notes](https://github.com/bakerboy448/StarrScripts/releases/tag/v4.0.0)
-
--   **Script:** `xseed-update.sh`
--   **Description:** Updates the [Cross-Seed](https://github.com/cross-seed/cross-seed) tool to its latest version.
+-   **Script:** `qui-xseed.sh`
+-   **Description:** Triggers a [qui](https://github.com/qui-lern/qui) data-based cross-seed search when Radarr or Sonarr completes an import. The script creates a dir-scan entry in qui, triggers a scan, polls for completion, then cleans up.
+-   **Creator:** [Bakerboy448](https://github.com/bakerboy448/)
+-   **Requirements:**
+    -   [qui](https://github.com/qui-lern/qui) with API access enabled
+    -   Radarr/Sonarr with Custom Script connect support
+-   **Instructions:**
+    1. Copy `.env.sample` to `.env` and configure the `QUI_*` variables.
+    2. Docker Users: Mount `.env` and `qui-xseed.sh` to your Starr's `/config` mount.
+    3. In Radarr: `Settings` -> `Connect` -> `Custom Script` -> select "On Import" and "On Upgrade".
+    4. In Sonarr: `Settings` -> `Connect` -> `Custom Script` -> select "On Import Complete".
+    5. Test and Save.
+-   **Configuration (`.env`):**
+    -   `QUI_HOST` - qui hostname (default: `localhost`)
+    -   `QUI_PORT` - qui API port (default: `7476`)
+    -   `QUI_APIKEY` - qui API key
+    -   `QUI_TARGET_INSTANCE_ID` - qui instance ID (default: `1`)
+    -   `QUI_QBIT_PATH_PREFIX` - optional path prefix for qBittorrent
+    -   `QUI_TAGS` - optional comma-separated tags
+    -   `TORRENT_CLIENTS` - comma-separated torrent client names (default: `qBittorrent`)
+    -   `USENET_CLIENTS` - comma-separated usenet client names (default: `SABnzbd`)
+    -   `LOG_FILE` - log file path (default: `./qui_xseed.log`)
+-   **Notes:**
+    -   Only errors are written to stderr (which starr apps capture). All other logging goes to the log file only, to avoid noisy notifications.
+    -   The script is idempotent — duplicate download IDs are skipped via the ID log file.
+    -   Replaces the legacy `xseed.sh` (removed in v4.0.0) which used the cross-seed API directly.
 
 ### Duplicate File Manager