qbittorrent-api

What it is and what it does

qbittorrent-api is a Python wrapper around the qBittorrent Web API that lets you control a qBittorrent instance programmatically. It handles the HTTP communication, authentication, and session management so you can focus on torrent operations—adding, removing, pausing, and querying torrents—through a clean Python interface. The library automatically detects your qBittorrent version and adapts to available API endpoints, and it manages login cookies transparently so you don't have to.

The package supports qBittorrent v5.2.3 (Web API v2.15.1) and works with Python 3.10 through 3.14. It depends only on packaging, requests, and urllib3, making it lightweight to install. The library is actively maintained, with releases tracking qBittorrent updates closely, and it includes a context-manager interface for safe resource cleanup.

Use it for:

• Automate torrent downloads and management in scripts or applications without manual WebUI interaction.
• Monitor torrent status and qBittorrent health metrics from external monitoring or logging systems.
• Build a custom dashboard or control panel that queries and manages torrents via qBittorrent's API.
• Integrate torrent operations into larger automation workflows or CI/CD pipelines.
• Programmatically add, pause, or remove torrents based on external triggers or conditions.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Python client library that wraps the qBittorrent Web API, allowing you to control torrents, manage application settings, and query status programmatically.

Yes. The package is actively maintained, has no known vulnerabilities, installs cleanly with minimal dependencies, and is MIT-licensed. It covers the full qBittorrent Web API surface and handles version compatibility automatically. Install it if you need to control qBittorrent from Python code.

Install

qbittorrent-api on PyPI

pip install qbittorrent-api

uv add qbittorrent-api

poetry add qbittorrent-api

Installing qbittorrent-api

Before you install

Low install friction with a pure-Python wheel and only three runtime dependencies (packaging, requests, urllib3). Active maintenance with a release 13 days ago; the project has been maintained since 2019 and tracks qBittorrent releases closely.

License in practice

MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute this package freely provided you include the license notice.

Quickstart

pip install qbittorrent-api

import qbittorrentapi

conn_info = dict(host="localhost", port=8080, username="admin", password="adminadmin")
qbt_client = qbittorrentapi.Client(**conn_info)
qbt_client.auth_log_in()
for torrent in qbt_client.torrents_info():
    print(f"{torrent.hash[-6:]}: {torrent.name} ({torrent.state})")

Requires Python 3.10 or later; requires a running qBittorrent instance with Web API enabled and network access to its WebUI port.

Verify before relying

• Whether automatic session-cookie renewal works reliably across network interruptions or long-lived client instances.
• Performance characteristics when managing large numbers of torrents or frequent API calls.

Package facts

Evidence: qbittorrent_api-2026.8.0-py3-none-any.whl

Keywords: python, qbittorrent, api, client, torrent, torrents, webui, web

Tags

More Utilities packages