LinuxCommandLibrary

deluge-console

Manage Deluge torrent client from command line

TLDR

Start the interactive console interface

$ deluge-console
copy

Connect to a Deluge daemon instance
$ connect [hostname]:[port]
copy

Add a torrent to the daemon
$ add [url|magnet|path/to/file]
copy

Display information about all torrents
$ info
copy

Display information about a specific torrent
$ info [torrent_id]
copy

Pause a torrent
$ pause [torrent_id]
copy

Resume a torrent
$ resume [torrent_id]
copy

Remove a torrent from the daemon
$ rm [torrent_id]
copy

SYNOPSIS

deluge-console [options] [command [arguments]]

PARAMETERS

-c, --config config_dir
    Specify the configuration directory. Default is ~/.config/deluge.

-L, --logfile filename
    Specify the log file. By default, it logs to stdout.

--level level
    Set the log level (e.g., debug, info, warning, error). Default is info.

--help
    Show help message and exit.

--version
    Show program's version number and exit.

command
    The command to execute (e.g., info, add, connect, config). If not provided, starts in interactive mode.

arguments
    Arguments to the specified command.

DESCRIPTION

deluge-console is a command-line interface for interacting with the Deluge BitTorrent client. It allows users to connect to a Deluge daemon (deluged) and manage torrents, configure settings, view status information, and perform other administrative tasks.

It provides a way to control Deluge without a graphical user interface, making it useful for headless servers, automated scripts, and remote management.

Users can add torrents, start/stop downloads, set priorities, view tracker information, and adjust global settings like download/upload limits and plugin configurations. The console uses an interactive mode that enables execution of Deluge commands or a non-interactive mode where a single command is run and the console exits.

INTERACTIVE MODE

If no command is provided, the console starts in interactive mode, presenting a command prompt. From here, users can enter commands and interact with the Deluge daemon directly.

NON-INTERACTIVE MODE

By providing a command as an argument to deluge-console, the command will be executed and console will terminate afterwards. This is useful in shell scripts.

SEE ALSO

deluged(1), deluge(1)

Copied to clipboard