deluge-client

What it is and what it does

deluge-client is a lightweight pure-Python library that acts as an RPC client for the Deluge torrent daemon. It allows you to connect to a running Deluge instance over the network and call remote methods to query torrent status, manage downloads, and control the daemon programmatically. The client supports both direct method calls via the `call()` method and attribute-style access (e.g., `client.core.get_torrents_status()`), and can be used as a context manager for automatic connection cleanup.

The package has no external runtime dependencies and installs cleanly on Python 3.8 through 3.12. It includes a local client variant for connecting to Deluge instances on the same machine without credentials, and supports automatic reconnection with retry logic. The main limitation is that it does not handle asynchronous events from the daemon, so additional unsolicited replies from Deluge can disrupt the data stream.

Use it for:

• Automate torrent management tasks by querying and controlling a Deluge daemon from a Python script or application.
• Build monitoring tools that periodically check torrent status, download progress, or daemon health via RPC calls.
• Integrate Deluge torrent control into a larger application or workflow without embedding the full Deluge daemon.
• Create a local wrapper or CLI tool that abstracts Deluge RPC calls for easier scripting and automation.
• Implement retry logic and automatic reconnection for robust long-running processes that interact with a potentially unstable Deluge instance.

Worth the install?

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

A lightweight pure-Python RPC client that connects to Deluge torrent daemon instances and executes remote procedure calls to query and control torrents.

Yes, if you need to control a Deluge daemon from Python and can tolerate dormant maintenance. The package is stable, has no dependencies, and works reliably for basic RPC operations. Install it only if you have a Deluge 1.3.x, 2.0, or 2.1 instance to connect to and do not require event handling or support for newer Deluge versions.

Install

deluge-client on PyPI

pip install deluge-client

uv add deluge-client

poetry add deluge-client

Installing deluge-client

Before you install

Low install friction with no runtime dependencies. Maintenance is dormant—last release was in February 2024 and no commits since May 2024—but the repository remains active and the package has been stable since its 2015 initial release.

License in practice

MIT license is permissive, allowing commercial and private use with minimal restrictions beyond attribution.

Quickstart

pip install deluge-client

from deluge_client import DelugeRPCClient

client = DelugeRPCClient('127.0.0.1', 12345, 'username', 'password')
client.connect()
result = client.call('core.get_torrents_status', {}, ['name'])

Requires a running Deluge daemon (version 1.3.x, 2.0, 2.1) accessible at the specified host and port; connection credentials must be correct.

Verify before relying

• Whether the package's event-handling limitation (noted as 'does not support events') is a blocker for your use case.
• Current compatibility with Deluge versions beyond 2.1 (last tested versions are 1.3.x, 2.0, 2.1).

Package facts

Evidence: deluge_client-1.10.2-py3-none-any.whl

Tags

More Python Modules packages