n8n-nodes-qbittorrent

This is an n8n community node. It lets you use qBittorrent in your n8n workflows.

qBittorrent is a software allowing you to download and upload torrents.
It also has a web server that can be controlled by a Rest API or an integrated web UI.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Development
Resources
Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

In short, from your n8n instance: Settings → Community nodes → Install, then enter n8n-nodes-qbittorrent.

Operations

Torrent

Operation	Description
getTorrentsList	Get torrents list
addTorrent	Add a torrent to the list
pauseTorrents	Pause torrents
resumeTorrents	Resume torrents
deleteTorrents	Delete torrents (optionally files)
recheckTorrents	Recheck torrents
reannounceTorrents	Reannounce torrents to their trackers
setTorrentCategory	Set the category of torrents
addTorrentTags	Add tags to torrents
removeTorrentTags	Remove tags from torrents
setTorrentLocation	Set the location of torrents
renameTorrent	Rename a torrent
getTorrentProperties	Get the properties of a torrent
getTorrentFiles	Get the files of a torrent
getTorrentTrackers	Get the trackers of a torrent
getCategories	Get all categories
createCategory	Create a category
getTags	Get all tags
createTags	Create tags

Transfer

Operation	Description
getGlobalTransferInfo	Get the global transfer info
getSpeedLimitsMode	Get the alternative speed limits state
toggleSpeedLimitsMode	Toggle the alternative speed limits

Application

Operation	Description
getAppVersion	Get API version
getBuildInfo	Get build info
getPreferences	Get application preferences

Operations acting on several torrents take a Torrent Hashes parameter: a pipe-separated list of hashes (hash1|hash2), or all to target every torrent.

Credentials

Before using a node, you have to add a credential.
This credential should be your server address and the username / password that have access to the web UI.

Make sure you don't include a slash at the end of the URL, otherwise you may encounter 404 errors when performing various operations.

The node logs in once and reuses the session cookie, refreshing it automatically when the session expires.

Compatibility

This node targets the qBittorrent WebUI API v2, and the primary target is qBittorrent 5.0+.

qBittorrent 5.0 renamed several torrent-control routes (for example torrents/pause/torrents/resume became torrents/stop/torrents/start). To stay compatible across versions, the node auto-detects the qBittorrent major version (via GET /api/v2/app/version) and routes accordingly: it uses stop/start on qBittorrent 5.x, and falls back to pause/resume on qBittorrent 4.x.

• qBittorrent 5.0+ is the primary, supported target.
• qBittorrent 4.x is supported for now through the version auto-detection fallback, but backward compatibility is not guaranteed going forward and may be dropped in a future release.

To avoid breakage with future releases of this node, keep your qBittorrent instance up to date (5.0+ recommended).

Development

Build the node and register it globally with npm:

cd <n8n_node_directory>
npm run build
npm link

Link it into the n8n custom nodes directory (~/.n8n/custom, create it first if it doesn't exist):

mkdir -p ~/.n8n/custom
cd ~/.n8n/custom
npm init -y   # only the first time
npm link n8n-nodes-qbittorrent

Run your n8n instance:

npx n8n

The node appears in the editor under its display name, qBittorrent.

After updating the code, run npm run build from the node directory and restart your n8n instance. See the Run your node locally guide for details.

Other useful scripts:

npm run dev     # tsc --watch
npm test        # vitest
npm run lint    # eslint
npm run format  # prettier

Resources

• n8n community nodes documentation
• qBittorrent WebUI API (v2) documentation

Version history

Current version supports the version 2 of the qBittorrent API.
If a new qBittorrent API version is released, a new major version of this node will be released.