LinuxCommandLibrary

deluge

Download and manage torrent files

TLDR

Download a torrent

$ deluge [url|magnet|path/to/file]
copy

Download a torrent using a specific configuration file
$ deluge [[-c|--config]] [path/to/configuration_file] [url|magnet|path/to/file]
copy

Download a torrent and launch the specified user interface
$ deluge -u [gtk|web|console] [url|magnet|path/to/file]
copy

Download a torrent and output the log to a file
$ deluge [[-l|--logfile]] [path/to/log_file] [url|magnet|path/to/file]
copy

SYNOPSIS

deluge [options] [torrent1 [torrent2 ...]]

PARAMETERS

-h, --help
    Show help message and exit

--apport
    Report crashes to Apport (Ubuntu)

--config-dir PATH
    Override config directory (default: ~/.config/deluge)

--logfile PATH
    Override log file location (default: ~/.config/deluge/deluge.log)

--loglevel LEVEL
    Set logging level: debug|info|warning|error (default: info)

--pidfile PATH
    Create pidfile at the given location

--profile
    Run with a profiler

--usage
    Display brief usage message

--version
    Show Deluge version

DESCRIPTION

Deluge is a free, open-source BitTorrent client available on Linux, Windows, and macOS. The deluge command launches its graphical user interface built with GTK+, designed to connect to the deluged daemon for a lightweight, thin-client architecture. This setup allows multiple interfaces (GUI, console, web) to control a single daemon process, optimizing resource usage.

Key features include drag-and-drop torrent addition, magnet link support, bandwidth scheduling, per-torrent speed limits, proxy and encryption options, RSS feed integration, and extensive plugin ecosystem (e.g., AutoAdd, LabelPlus, Scheduler). Users can monitor download/upload speeds, peer connections, and file priorities in real-time. Preferences are managed via a tabbed interface covering core, cache, bandwidth, and plugins.

Primarily for power users seeking customization, Deluge uses libtorrent rasterbar as its core engine, ensuring high performance and compatibility with modern torrent standards like uTP and DHT. It's ideal for seedboxes or multi-interface setups but requires the daemon for remote control.

CAVEATS

Requires deluged daemon for full functionality; GUI acts as thin client. Standalone mode limited. GTK+ UI deprecated in recent versions in favor of web/console.

ARGUMENTS

Accepts .torrent files or magnet: links directly on command line for immediate addition.

DAEMON SETUP

Start with deluged; UI auto-connects via default host:58846. Edit ~/.config/deluge/core.conf for custom settings.

HISTORY

Deluge project started in 2006 by Zachariah Bergman. Initial GTK UI; evolved to daemon/client model by 2007. Adopted libtorrent in 2008. Version 2.0 (2019-2022) added modern features, async I/O. Widely used in Linux distros since 2008.

SEE ALSO

deluged(1), deluge-console(1), deluge-web(1), transmission-gtk(1), rtorrent(1)

Copied to clipboard