Overview
This node integrates with a qBittorrent instance via its web API to add new torrents for downloading. It is useful in automation workflows where you want to programmatically manage torrent downloads, such as adding multiple torrents from URLs, organizing them into categories, or setting specific download/upload limits.
Typical use cases include:
- Automatically adding torrents from RSS feeds or other sources.
- Managing torrent download settings like save paths, speed limits, and seeding rules.
- Organizing torrents by categories and tags for easier management.
For example, you could set up a workflow that listens for new torrent URLs and adds them to your qBittorrent client with predefined settings like paused state or sequential download enabled.
Properties
| Name | Meaning |
|---|---|
| Torrent URL | URLs of the torrent files to add, separated by newlines. |
| Save Path | Folder path where the torrent content will be downloaded. |
| Cookie | Cookie string sent when downloading the .torrent file (useful for authenticated downloads). |
| Category | Category label assigned to the torrent for organizational purposes. |
| Tags | Comma-separated tags to assign to the torrent. |
| Skip Hash Checking | Whether to skip hash checking on the torrent files. Possible values: "true", "false" (default). |
| Paused | Add the torrent in a paused state. Possible values: "true", "false" (default). |
| Create Root Folder | Whether to create a root folder for the torrent. Possible values: "true", "false", unset (default). |
| Rename Torrent | New name to assign to the torrent. |
| Upload Limit | Upload speed limit for the torrent in bytes per second. |
| Download Limit | Download speed limit for the torrent in bytes per second. |
| Ratio Limit | Share ratio limit for the torrent. |
| Seeding Time Limit | Seeding time limit in minutes. |
| Automatic Torrent Management | Enable automatic torrent management (boolean). |
| Sequential Download | Enable sequential download. Possible values: "true", "false" (default). |
| First Last Piece Priority | Prioritize downloading the first and last pieces of the torrent. Possible values: "true", "false" (default). |
Output
The node outputs the response from the qBittorrent API after attempting to add the torrent(s). The output is structured as JSON data representing the result of the add operation, which typically includes success confirmation or error details.
No binary data output is involved in this operation.
Dependencies
- Requires access to a running qBittorrent instance with its Web UI/API enabled.
- Requires an API authentication token or credentials configured in n8n to authenticate requests to the qBittorrent API.
- The node sends HTTP POST requests with multipart/form-data encoding to the
/torrents/addendpoint of the qBittorrent API.
Troubleshooting
- Invalid or missing torrent URLs: Ensure the "Torrent URL" property contains valid URLs separated by newlines.
- Authentication errors: Verify that the API credentials are correctly configured and have sufficient permissions.
- Network connectivity issues: Confirm that the qBittorrent instance is reachable from the n8n environment.
- Incorrect property values: For boolean-like properties ("true"/"false"), ensure correct string values are used as expected by the API.
- API errors: If the API returns errors, check the message for hints such as invalid parameters or server-side issues.