Deluge

Deluge Skill

Use this skill to manage torrents on a remote Deluge WebUI instance via JSON-RPC.

Requirements

• Python 3 with requests installed
• A running Deluge WebUI
• --url is required; password must be set via the DELUGE_PASSWORD environment variable

Usage

uv run bin/deluge_client.py --url  [--verify] COMMAND

Global Options

| Flag | Default | Description | |------|---------|-------------| | --url | (required) | Full Deluge WebUI URL (e.g. http://deluge.home.arpa:8112) | | --verify | off | Verify SSL certificate |

SSL is determined automatically from the URL scheme (http vs https).

Commands

list

List all torrents with state, progress, and size.

uv run bin/deluge_client.py --url URL list

add

Add a torrent by magnet URI or HTTP URL.

uv run bin/deluge_client.py --url URL add "magnet:?xt=urn:btih:..."
uv run bin/deluge_client.py --url URL add "https://example.com/file.torrent"

remove

Remove a torrent by ID (full or 8-char prefix). Use --with-data to also delete downloaded files.

uv run bin/deluge_client.py --url URL remove 
uv run bin/deluge_client.py --url URL remove  --with-data

pause

Pause a torrent by ID.

uv run bin/deluge_client.py --url URL pause 

resume

Resume a paused torrent by ID.

uv run bin/deluge_client.py --url URL resume 

call

Make a raw JSON-RPC call to the Deluge API. Params must be a JSON array string.

uv run bin/deluge_client.py --url URL call core.get_config_value '["download_location"]'

Notes

• SSL is determined by the URL scheme; certificate verification is off by default (accommodates self-signed certs)
• Torrent IDs shown by list are truncated to 8 chars for display; pass the full ID to remove
• Use call for any Deluge RPC method not covered by the built-in commands
• Always inject the password via the exec tool's env parameter — never inline it in the command string, as that will expose it in command logs and process listings:

{
  "command": "uv run bin/deluge_client.py --url http://deluge.home.arpa:8112 list",
  "env": { "DELUGE_PASSWORD": "" }
}

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: haliphax-ai
• Source: haliphax-ai/skills
• License: Unlicense

Install and usage instructions live in the source repository linked above.