qBittorrent Skill

Manage torrents via qBittorrent WebUI from Clawdbot.

What It Does

List torrents — filter by status, category, or tags
Add torrents — by magnet link, URL, or local file
Control downloads — pause, resume, delete, recheck
Speed limits — set upload/download limits
Categories & tags — organize your torrents

Setup

1. Enable WebUI

Open qBittorrent
Go to Tools → Options → Web UI
Enable Web User Interface (Remote control)
Set a username and password
Note the port (default: 8080)

2. Create Credentials File

mkdir -p ~/.clawdbot/credentials/qbittorrent
cat > ~/.clawdbot/credentials/qbittorrent/config.json << 'EOF'
{
  "url": "http://localhost:8080",
  "username": "admin",
  "password": "your-password-here"
}
EOF

Replace with your actual WebUI credentials.

3. Test It

./skills/qbittorrent/scripts/qbit-api.sh version

Usage Examples

List torrents

# All torrents
qbit-api.sh list

# Filter by status
qbit-api.sh list --filter downloading
qbit-api.sh list --filter seeding
qbit-api.sh list --filter paused

# Filter by category
qbit-api.sh list --category movies

Add torrents

# By magnet link
qbit-api.sh add "magnet:?xt=..." --category movies

# By .torrent file
qbit-api.sh add-file /path/to/file.torrent --paused

Control torrents

qbit-api.sh pause <hash>      # or "all"
qbit-api.sh resume <hash>     # or "all"
qbit-api.sh delete <hash>     # keep files
qbit-api.sh delete <hash> --files  # delete files too

Speed limits

qbit-api.sh transfer          # view current speeds
qbit-api.sh set-speedlimit --down 5M --up 1M

Categories & tags

qbit-api.sh categories
qbit-api.sh tags
qbit-api.sh set-category <hash> movies
qbit-api.sh add-tags <hash> "important,archive"

Environment Variables (Alternative)

Instead of a config file, you can set:

export QBIT_URL="http://localhost:8080"
export QBIT_USER="admin"
export QBIT_PASS="your-password"

Troubleshooting

"QBIT_URL must be set"
→ Check your config file exists at ~/.clawdbot/credentials/qbittorrent/config.json

Connection refused
→ Make sure WebUI is enabled in qBittorrent settings

403 Forbidden
→ Check username/password, or whitelist your IP in qBittorrent WebUI settings

"Banned" after too many attempts
→ qBittorrent bans IPs after failed logins — wait or restart qBittorrent

License

MIT

2.5 KiB Raw Blame History