Deluge
I needed a way to inject torrents into Deluge bittorrent client via Python for a few projects.
Comparison
Initially, I was using the deluge-client, which worked well but had a key limitation: it doesn't support HTTP connections, making it incompatible with setups using reverse proxies.
Given this limitation and my need for HTTP support, I decided to create my own solution. While the original goal was to make a utility for personal use, I realized others might benefit from it as well, so I expanded it into a more polished tool for the community.
Target Audience
Anyone that would like to utilize python to interact with their Deluge bittorrent client.
DelugeWebClient
A Python client for the Deluge Web API, with support for HTTP connections, making it ideal for reverse proxy setups or direct URL access.
Key Features
Full access to most Deluge Web API methods, including core functionalities through RPC. Designed for use in projects where HTTP connections are essential. Easy to integrate and use, with a clear API and support for common tasks like uploading torrents and managing torrents. I took inspiration from qbittorrent-api, and I hope this project proves helpful to anyone looking for a flexible, HTTP-capable Deluge Web API client.
Feedback and Contributions Feel free to try it out, give feedback, report any issues, or contribute on GitHub. Any suggestions or contributions to make it better are welcome!
Example Usage
Code: Select all
from deluge_web_client import DelugeWebClient
# using a context manager automatically logs you in
with DelugeWebClient(url="https://site.net/deluge", password="example_password") as client:
upload = client.upload_torrent(
torrent_path="filepath.torrent",
add_paused=False, # optional
seed_mode=False, # optional
auto_managed=False, # optional
save_directory=None, # optional
label=None, # optional
)
print(upload)
# Response(result="0407326f9d74629d299b525bd5f9b5dd583xxxx", error=None, id=1)
Project
PyPi
Docs
