deluge-console

Start the interactive console interface

$ deluge-console

$ connect [hostname]:[port]

$ add [url|magnet|path/to/file]

$ info

$ info [torrent_id]

$ pause [torrent_id]

$ resume [torrent_id]

$ rm [torrent_id]

deluge-console [options] [command [args...]]

-h, --help
    Show help message and exit

-v, --version
    Show version number and exit

-c DIR, --config-dir=DIR
    Set config directory (default: ~/.config/deluge)

-L lvl, --loglevel=lvl
    Set log level: 0=Disable,1=Critical,2=Error,3=Warning,4=Message(default),5=Info,6=Debug,7=Fuzzy

-l file, --logfile=file
    Set log file (default: ~/.config/deluge/console.log)

-q, --quiet
    Decrease log verbosity

-d, --debug
    Set log level to debug

-u URL, --url=URL
    Connect to deluge://host:port URL

deluge-console is a full-screen, ncurses-based command-line interface for managing torrents in the Deluge BitTorrent client. It connects to a running deluged daemon, either locally or remotely, allowing users to add torrents via files or magnet links, monitor progress, control downloads/uploads, adjust priorities, view peer details, and configure preferences interactively.

The interface splits the screen into panels: torrent list, selected torrent details (files, trackers, peers), command input, and status bar. Navigation uses keyboard shortcuts like arrow keys, h/j/k/l (vim-style), or mouse if supported. It's perfect for headless servers accessed via SSH, offering a lightweight alternative to GUI clients like deluge-gtk.

Supports non-interactive scripting by passing commands as arguments or piping them. Authentication uses settings from the config directory or specified URL. Debug and logging options help diagnose connection or daemon issues. Cross-platform but optimized for Unix-like systems.

Requires running deluged daemon and compatible terminal for ncurses. Remote connections need authentication in config or URL. Non-interactive mode limited to simple commands.

add [-p <path>] <torrent|magnet>
info
pause [<torrentid>]
resume [<torrentid>]
remove -r [<torrentid>]
help
shutdown

Uses auth from ~/.config/deluge/auth or core.conf. For remote: specify --url=deluge://user:pass@host:58846.

Introduced in early Deluge releases (~2008) as part of the open-source BitTorrent client project started in 2006. Evolved for better remote management; current in Deluge 2.x with libtorrent integration.

deluged(1), deluge(1), deluge-gtk(1), deluge-web(1)