Overview
This node integrates with a qBittorrent instance via its web API, specifically allowing users to add new torrents for downloading. It is useful in scenarios where automated torrent management is desired, such as adding multiple torrent downloads programmatically from URLs or managing torrent settings dynamically within an automation workflow.
Practical examples include:
- Automatically adding torrents from RSS feeds or external sources.
- Setting download/upload limits or categories on newly added torrents.
- Managing torrent states (paused/active) and folder organization upon addition.
Properties
| Name | Meaning |
|---|---|
| Torrent URL | One or more torrent URLs separated by newlines to be added to the qBittorrent client. |
| Additional Parameters | Optional settings to customize how the torrent is added: |
| - Automatic Torrent Management | Enable or disable automatic torrent management (true/false). |
| - Category | Assign a category label to the torrent. |
| - Cookie | HTTP cookie string sent when downloading the .torrent file. |
| - Create Root Folder | Whether to create a root folder for the torrent ("true", "false", or unset). |
| - Download Limit | Set maximum download speed limit in bytes per second. |
| - First Last Piece Priority | Prioritize downloading the first and last pieces of the torrent (true/false). |
| - Paused | Add the torrent in a paused state if true. |
| - Ratio Limit | Set the share ratio limit for seeding. |
| - Rename Torrent | Rename the torrent after adding it. |
| - Save Path | Specify the download folder path. |
| - Seeding Time Limit | Set maximum seeding time in minutes. |
| - Sequential Download | Enable sequential downloading (true/false). |
| - Skip Hash Checking | Skip hash checking on the torrent files (true/false). |
| - Tags | Comma-separated tags to assign to the torrent. |
| - Upload Limit | Set maximum upload speed limit in bytes per second. |
Output
The node outputs JSON data representing the result of the add torrent operation. This typically includes confirmation details such as success status, any error messages, or metadata about the added torrent(s).
No binary data output is produced by this operation.
Dependencies
- Requires access to a running qBittorrent instance with its Web UI/API enabled.
- Needs credentials including the qBittorrent URL, username, and password for authentication.
- The node uses the qBittorrent Web API v2 endpoints.
- No additional external services are required beyond the qBittorrent server.
Troubleshooting
- Authentication errors: Ensure the provided URL, username, and password are correct and that the qBittorrent Web UI is accessible.
- Invalid torrent URLs: Verify that the URLs are valid and accessible; malformed or unreachable URLs will cause failures.
- Permission issues: Check that the user account has sufficient permissions to add torrents.
- Network connectivity: Confirm network access between n8n and the qBittorrent server.
- Parameter validation: Incorrect parameter types or unsupported values (e.g., invalid boolean strings) may cause errors.
Common error messages might indicate authentication failure, invalid input parameters, or connection timeouts. Resolving these usually involves verifying credentials, input correctness, and network setup.