# Qbittorrent > Manage torrents with qBittorrent. Use when the user asks to "list torrents", "add torrent", "pause torrent", "resume torrent", "delete torrent", "check download status", "torrent speed", "qBittorrent stats", or mentions qBittorrent/qbit torrent management. - **Type:** Skill - **Install:** `agentstack add skill-jmagar-claude-homelab-qbittorrent` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [jmagar](https://agentstack.voostack.com/s/jmagar) - **Installs:** 0 - **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [jmagar](https://github.com/jmagar) - **Source:** https://github.com/jmagar/claude-homelab/tree/main/skills/qbittorrent ## Install ```sh agentstack add skill-jmagar-claude-homelab-qbittorrent ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # qBittorrent WebUI API **⚠️ MANDATORY SKILL INVOCATION ⚠️** **YOU MUST invoke this skill (NOT optional) when the user mentions ANY of these triggers:** - "qBittorrent status", "torrent list", "active torrents" - "pause torrent", "resume torrent", "delete torrent" - "add torrent", "qBit", "download manager" - Any mention of qBittorrent or torrent management **Failure to invoke this skill when triggers occur violates your operational requirements.** Manage torrents via qBittorrent's WebUI API (v4.1+). ## Purpose This skill provides **read and write** access to your qBittorrent torrent client: - Monitor active, seeding, and completed torrents - Add torrents by magnet link, URL, or file upload - Control torrent state (pause, resume, delete) - Manage categories and tags - Adjust global and per-torrent speed limits - View torrent files, trackers, and properties - Recheck torrent data integrity Operations include both read and write actions. **Always confirm before deleting torrents with file deletion.** ## Setup Add credentials to `~/.claude-homelab/.env`: ```bash QBITTORRENT_URL="http://localhost:8080" QBITTORRENT_USERNAME="admin" QBITTORRENT_PASSWORD="adminadmin" ``` Set file permissions: ```bash chmod 600 ~/.claude-homelab/.env ``` ## Quick Reference ### List Torrents ```bash # All torrents ./scripts/qbit-api.sh list # Filter by status ./scripts/qbit-api.sh list --filter downloading ./scripts/qbit-api.sh list --filter seeding ./scripts/qbit-api.sh list --filter paused # Filter by category ./scripts/qbit-api.sh list --category movies ``` Filters: `all`, `downloading`, `seeding`, `completed`, `paused`, `active`, `inactive`, `stalled`, `errored` ### Get Torrent Info ```bash ./scripts/qbit-api.sh info ./scripts/qbit-api.sh files ./scripts/qbit-api.sh trackers ``` ### Add Torrent ```bash # By magnet or URL ./scripts/qbit-api.sh add "magnet:?xt=..." --category movies # By file ./scripts/qbit-api.sh add-file /path/to/file.torrent --paused ``` ### Control Torrents ```bash ./scripts/qbit-api.sh pause # or "all" ./scripts/qbit-api.sh resume # or "all" ./scripts/qbit-api.sh delete # keep files ./scripts/qbit-api.sh delete --files # delete files too ./scripts/qbit-api.sh recheck ``` ### Categories & Tags ```bash ./scripts/qbit-api.sh categories ./scripts/qbit-api.sh tags ./scripts/qbit-api.sh set-category movies ./scripts/qbit-api.sh add-tags "important,archive" ``` ### Transfer Info ```bash ./scripts/qbit-api.sh transfer # global speed/stats ./scripts/qbit-api.sh speedlimit # current limits ./scripts/qbit-api.sh set-speedlimit --down 5M --up 1M ``` ### App Info ```bash ./scripts/qbit-api.sh version ./scripts/qbit-api.sh preferences ``` ## Response Format Torrent object includes: - `hash`, `name`, `state`, `progress` - `dlspeed`, `upspeed`, `eta` - `size`, `downloaded`, `uploaded` - `category`, `tags`, `save_path` States: `downloading`, `stalledDL`, `uploading`, `stalledUP`, `pausedDL`, `pausedUP`, `queuedDL`, `queuedUP`, `checkingDL`, `checkingUP`, `error`, `missingFiles` ## Workflow When the user asks about torrents: 1. **"What's downloading?"** → Run `list --filter downloading` 2. **"Add this magnet link"** → Run `add ""` with appropriate category 3. **"Pause all torrents"** → Run `pause all` 4. **"Resume seeding"** → Run `resume all` or filter by hash 5. **"Show torrent details"** → Run `info ` and `files ` 6. **"List by category"** → Run `list --category movies` 7. **"Set speed limits"** → Run `set-speedlimit --down 5M --up 1M` ## Notes - Requires network access to your qBittorrent server - Uses qBittorrent WebUI API v4.1+ - All data operations return JSON - **Delete operations with --files are permanent** - always confirm before deleting downloaded files - Speed limits support units: K (KB/s), M (MB/s), or raw bytes - Magnet links and torrent URLs are added without local file upload - Categories must exist before assignment (create via WebUI or API) --- ## 🔧 Agent Tool Usage Requirements **CRITICAL:** When invoking scripts from this skill via the zsh-tool, **ALWAYS use `pty: true`**. Without PTY mode, command output will not be visible even though commands execute successfully. **Correct invocation pattern:** ```typescript ./skills/SKILL_NAME/scripts/SCRIPT.sh [args] true ``` ### Scripts | Script | Purpose | |--------|---------| | `qbit-api.sh` | Main API wrapper — all torrent operations | | `qbit-api-wrapper.sh` | Thin PTY shim — captures and re-prints `qbit-api.sh` output via `printf` to ensure visibility in environments where stdout buffering may suppress output | ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [jmagar](https://github.com/jmagar) - **Source:** [jmagar/claude-homelab](https://github.com/jmagar/claude-homelab) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** yes - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-jmagar-claude-homelab-qbittorrent - Seller: https://agentstack.voostack.com/s/jmagar - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.