qbt-hub

Manage qBittorrent downloads via the WebUI API using a Python CLI script.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/lsongdev/skills --skill qbt-hub-lsongdev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: qbt-hub
Source: https://github.com/lsongdev/skills/tree/main/qbt
Command: npx skills add https://github.com/lsongdev/skills --skill qbt-hub-lsongdev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Managing a remote qBittorrent instance normally requires opening the WebUI in a browser and clicking through menus. This Skill lets you control every aspect of qBittorrent (v5.0+) directly from the command line or an AI agent, from adding magnet links to tuning speed limits and RSS rules. ## Core Features & Use Cases - Task Lifecycle Management: Add torrents via magnet link, URL, or local .torrent file, then pause, resume, recheck, rename, move, or delete them with fuzzy keyword matching. - Monitoring & Filtering: List and sort tasks by status, tag, category, size, speed, or ratio; inspect per-task details including files, trackers, and peers; view global transfer status. - Bandwidth & Organization Control: Set per-task or global download/upload speed limits, toggle turtle mode, and organize downloads with tags and categories. - RSS Automation: Add RSS feeds and create auto-download rules with pattern matching and category assignment. - Use Case: Ask the agent to find a Linux ISO magnet link on the web, add it to qBittorrent with a save path and tags, then check download progress and limit its speed during work hours. ## Quick Start Ask the agent to add this magnet link to qBittorrent and show the current download progress.

Frequently Asked Questions about qbt-hub

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a magnet link to qBittorrent from the command line?▼

Run python3 qbt.py add followed by the magnet link in quotes. You can optionally set --savepath, --category, --tags, --paused, and --sequential flags to control where and how the download starts.

How do I check qBittorrent download progress without the WebUI?▼

Use python3 qbt.py list --filter downloading to see active downloads with progress, speed, and ETA, or python3 qbt.py status for global transfer speeds and totals. The info command shows per-task details including files and trackers.

What qBittorrent version does this WebUI API client support?▼

The script targets qBittorrent v5.0 and later, using the /api/v2/ WebUI endpoints. It authenticates via the auth/login endpoint with a cookie session and requires the WebUI to be enabled on the target instance.

How do I set qBittorrent speed limits per task or globally?▼

Use python3 qbt.py limit with a task keyword and --dl/--ul values in KB/s for per-task limits, or python3 qbt.py speedlimit --dl 2048 --ul 512 for global limits. Passing 0 removes the limit, and --alt toggles turtle mode.

Can I automate qBittorrent downloads with RSS feeds?▼

Yes, the rss command lists, adds, and removes feeds, and addrule creates auto-download rules with a name, match pattern, and target category. Rules use qBittorrent's built-in RSS downloader with mustContain matching.

Why does qBittorrent login fail when running the script?▼

Login fails when the host is unreachable or credentials are wrong. Verify QBT_HOST, QBT_USER, and QBT_PASS environment variables, or override them per-call with --host, --user, and --pass flags.