qbittorrent_skill

Overview

This skill manages torrents through qBittorrent's WebUI API (v4.1+). It exposes common torrent operations—listing, adding, pausing, resuming, deleting, and retrieving status and transfer stats—so you can control qBittorrent from the agent.

How this skill works

The skill talks to qBittorrent's WebUI using configured credentials (URL, username, password) and maps user intents to API actions. It returns torrent objects with key fields (hash, name, state, progress, speeds, size, category, tags, save_path) and supports filtering, category/tag management, and global transfer controls.

When to use it

• When you want a concise list of current torrents with filters (downloading, seeding, paused, etc.).
• When adding a torrent by magnet link, URL, or .torrent file and optionally placing it in a category or paused state.
• When pausing, resuming, rechecking, or deleting one or multiple torrents (optionally removing files).
• When checking download/upload speeds, ETA, and global transfer statistics or setting speed limits.
• When inspecting torrent details like files, trackers, or tags for troubleshooting or archiving.

Best practices

• Store qBittorrent credentials in the configured credentials file (e.g., ~/.clawdbot/credentials/qbittorrent/config.json) and avoid exposing them in chat.
• Use filters (status, category) when listing torrents to reduce noise and improve relevance.
• Tag or set categories for torrents on add to keep downloads organized for automation or archival workflows.
• Prefer magnet links for quick adds; use add-file for seeding existing .torrent files and use --paused when you need to verify before downloading.
• Confirm delete operations when files will be removed to avoid accidental data loss.

Example use cases

• List all active downloads and show per-torrent progress, dlspeed, eta, and save path.
• Add a movie via magnet and assign it to the 'movies' category, starting it paused for manual inspection.
• Pause all torrents before shutting down a system or resume them after network maintenance.
• Delete completed torrents while keeping local files, or remove both torrent entries and data when freeing space.
• Query global transfer stats and set download/upload speed limits for bandwidth management.