Skip to content

Deluge: Add ltconfig plugin and update to current version #207

@MagnaCapax

Description

@MagnaCapax

Problem

ltconfig plugin missing:
ltconfig (libtorrent configuration plugin) is not included in Deluge installations. This plugin allows users to fine-tune libtorrent settings for better performance.

Deluge version outdated:
Current installation is Deluge 2.0.5 (released 2019), which is significantly outdated. Latest stable is 2.1.x series.

Installation method inconsistency:
Investigation shows Deluge 2.0.5 is installed via pip/easy_install (Python 2) even on Debian 12 servers, despite update script expecting apt packages for Debian 11+.

Investigation Findings

Current installation (live server - Debian 12):

  • Deluge 2.0.5 installed via pip/easy_install
  • Binary location: /usr/local/bin/deluged
  • Python 2.7 based (deprecated)
  • No ltconfig plugin installed

Expected installation per update script:

  • scripts/lib/update/apps/deluge.php shows Debian 11+ should use apt packages
  • Only Debian 10 should use pip installation route
  • Server is using Debian 10 path despite being Debian 12

Package availability:

  • selections-debian12.txt includes: deluge-common, deluge-console, deluge-web, deluged (all marked install)
  • Indicates apt packages ARE available for Debian 12

Related Issues

  • GH#23: Deluge plugins (generic, no specifics about ltconfig)
  • GH#125: Converge Deluge installer to dpkg baselines or pinned virtualenv
  • GH#194: security: deluge.php — HTTPS + checksums + runStep hardening

What is ltconfig

ltconfig is a Deluge plugin that exposes advanced libtorrent settings in the web UI:

  • Connection limits
  • Disk I/O settings
  • Protocol optimization
  • Performance tuning

Benefits:

  • Users can optimize for their specific use case (racing vs long-term seeding)
  • Better control over resource usage
  • Improved performance for power users

Plugin source: https://github.com/ratanakvlun/deluge-ltconfig

Requirements

ltconfig Plugin

  • Include ltconfig in default Deluge installation
  • Install to appropriate plugin directory
  • Enable by default or provide user documentation for enabling

Deluge Version Update

  • Update to latest stable Deluge 2.1.x
  • Ensure compatibility with existing user configs
  • Test migration path from 2.0.5 to 2.1.x

Installation Method

  • Prefer apt packages where available (Debian 11+)
  • If pip is required, use Python 3 and virtualenv (per GH#125)
  • Document why manual installation is used if apt is insufficient

Technical Notes

ltconfig installation:

  • Plugin .egg file must be placed in Deluge plugins directory
  • Can be installed per-user or system-wide
  • Requires Deluge restart to load

Deluge 2.0.5 -> 2.1.x migration:

  • Config format is backward compatible
  • Python 2 -> Python 3 migration required
  • Test with existing user sessions

Debian package versions:

  • Debian 11 (Bullseye): deluge 2.0.3
  • Debian 12 (Bookworm): deluge 2.0.5 or 2.1.1 (depends on repo)
  • May need backports or custom repo for latest version

Action Items

  1. Investigate why Debian 12 servers are using pip installation instead of apt
  2. Decide on target Deluge version (2.1.x latest stable)
  3. Test ltconfig compatibility with target version
  4. Update installation script to include ltconfig
  5. Test migration path with existing users
  6. Document any breaking changes or user-visible changes

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions