Application¶

class AppAPIMixIn(host=None, port=None, username=None, password=None, api_key=None, EXTRA_HEADERS=None, REQUESTS_ARGS=None, HTTPADAPTER_ARGS=None, VERIFY_WEBUI_CERTIFICATE=True, FORCE_SCHEME_FROM_HOST=False, RAISE_NOTIMPLEMENTEDERROR_FOR_UNIMPLEMENTED_API_ENDPOINTS=False, RAISE_ERROR_FOR_UNSUPPORTED_QBITTORRENT_VERSIONS=False, VERBOSE_RESPONSE_LOGGING=False, SIMPLE_RESPONSES=False, DISABLE_LOGGING_DEBUG_OUTPUT=False) → None¶

Bases: AuthAPIMixIn

Implementation of all Application API methods.

Usage:

>>> from qbittorrentapi import Client
>>> client = Client(host="localhost:8080", username="admin", password="adminadmin")
>>> client.app_version()
>>> client.app_preferences()

app_build_info(**kwargs) → BuildInfoDictionary¶

qBittorrent build info.

This method was introduced with qBittorrent v4.2.0 (Web API v2.3).

Return type:: BuildInfoDictionary

app_cookies(**kwargs) → CookieList¶

Retrieve current cookies.

Return type:: CookieList

app_default_save_path(**kwargs) → str¶

The default path where torrents are saved.

Return type:: str

app_get_directory_content(directory_path=None, with_metadata=None) → DirectoryContentList¶

The contents of a directory file path.

Raises:

NotFound404Error – file path not found or not a directory

Parameters:

directory_path (str | PathLike[AnyStr] | None) – file system path to directory
with_metadata (bool | None) – include file/directory metadata

Return type:

DirectoryContentList

app_network_interface_address_list(interface_name='', **kwargs) → NetworkInterfaceAddressList¶

The addresses for a network interface; omit name for all addresses.

This method was introduced with qBittorrent v4.2.0 (Web API v2.3).

Parameters:: interface_name (str) – Name of interface to retrieve addresses for
Return type:: NetworkInterfaceAddressList

app_network_interface_list(**kwargs) → NetworkInterfaceList¶

The list of network interfaces on the host.

This method was introduced with qBittorrent v4.2.0 (Web API v2.3).

Return type:: NetworkInterfaceList

app_preferences(**kwargs) → ApplicationPreferencesDictionary¶

Retrieve qBittorrent application preferences.

Return type:: ApplicationPreferencesDictionary

app_process_info(**kwargs) → ProcessInfoDictionary¶

Information about the process running qBittorrent.

This method was introduced with qBittorrent v5.2.0 (Web API v2.15.1).

Return type:: ProcessInfoDictionary

app_send_test_email() → None¶

Sends a test email using the configured email address.

Return type:: None

app_set_cookies(cookies=None, **kwargs) → None¶

Set cookies.

cookies = [
    {
        'domain': 'example.com',
        'path': '/example/path',
        'name': 'cookie name',
        'value': 'cookie value',
        'expirationDate': 1729366667,
    },
]

Parameters:: cookies (CookieList | Sequence[Mapping[str, str | int]] | None) – list of cookies to set
Return type:: None

app_set_preferences(prefs=None, **kwargs) → None¶

Set one or more preferences in qBittorrent application.

Parameters:: prefs (ApplicationPreferencesDictionary | Mapping[str, Any] | None) – dictionary of preferences to set
Return type:: None

app_shutdown(**kwargs) → None¶

Shutdown qBittorrent.

Return type:: None

app_version(**kwargs) → str¶

qBittorrent application version.

Return type:: str

app_web_api_version(**kwargs) → str¶

qBittorrent Web API version.

Return type:: str

class Application(*args, client, **kwargs)¶

Allows interaction with Application API endpoints.

Usage:

>>> from qbittorrentapi import Client
>>> client = Client(host="localhost:8080", username="admin", password="adminadmin")
>>> # these are all the same attributes that are available as named in the
>>> #  endpoints or the more pythonic names in Client (with or without 'app_' prepended)
>>> webapiVersion = client.application.webapiVersion
>>> web_api_version = client.application.web_api_version
>>> app_web_api_version = client.application.web_api_version
>>> # access and set preferences as attributes
>>> is_dht_enabled = client.application.preferences.dht
>>> # supports sending a just subset of preferences to update
>>> client.application.preferences = dict(dht=(not is_dht_enabled))
>>> prefs = client.application.preferences
>>> prefs["web_ui_clickjacking_protection_enabled"] = True
>>> client.app.preferences = prefs
>>>
>>> client.application.shutdown()