Client Handling settings
Use Settings → Client Handling after creating entries under Torrent Clients. The selectors contain configured client names and reject stale references when saved.
| Field | Purpose |
|---|---|
| Default client | Fallback client for search and injection when their dedicated selectors are empty. |
| Injected clients | Set of clients that receive successfully registered torrents. |
| Searching clients | qBittorrent or qui-backed clients searched for existing reusable torrents. |
Selection order
Injection uses the first applicable source:
- workflow or tracker-specific client override;
- Injected clients;
- Default client;
- the only configured client, when exactly one exists.
Search uses the first applicable source:
- workflow client override;
- Searching clients;
- Default client;
- all configured qBittorrent and qui-backed clients.
Watch-folder clients can receive torrent files but are not used for torrent search. Removing a Torrent Clients entry in the Web UI also clears its global and tracker references before save.
Verify the change
Save, prepare a source already present in the intended search client, and inspect client-discovery results. For first injection, keep Skip client injection enabled during review, then perform one controlled upload after confirming paths, categories, and tags.