Skip to main content

Python client for qBittorrent v4.1+ Web API

Project description

qBittorrent Web API Client

GitHub Workflow Status (branch) Codecov branch Coverity Scan Codacy grade

PyPI PyPI - Python Version PyPI - Implementation

Python client implementation for qBittorrent Web API. Supports qBittorrent v4.1.0+ (i.e. Web API v2.0+).

Currently supports up to qBittorrent v4.3.8 (Web API v2.8.2) released on Aug 28, 2021.

Find the full documentation for this client on RTD.


  • The entire qBittorrent Web API is implemented.
  • qBittorrent version checking for an endpoint's existence/features is automatically handled.
  • All Python versions are supported.
  • If the authentication cookie expires, a new one is automatically requested in line with any API call.


Install via pip from PyPI

pip install qbittorrent-api

Getting Started

import qbittorrentapi

# instantiate a Client using the appropriate WebUI configuration
qbt_client = qbittorrentapi.Client(host='localhost', port=8080, username='admin', password='adminadmin')

# the Client will automatically acquire/maintain a logged in state in line with any request.
# therefore, this is not necessary; however, you may want to test the provided login credentials.
except qbittorrentapi.LoginFailed as e:

# display qBittorrent info
print(f'qBittorrent: {}')
print(f'qBittorrent Web API: {}')
for k,v in print(f'{k}: {v}')

# retrieve and show all torrents
for torrent in qbt_client.torrents_info():
    print(f'{torrent.hash[-6:]}: {} ({torrent.state})')

# pause all torrents

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for qbittorrent-api, version 2021.8.23
Filename, size File type Python version Upload date Hashes
Filename, size qbittorrent_api-2021.8.23-py3-none-any.whl (48.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size qbittorrent-api-2021.8.23.tar.gz (44.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page