LinuxCommandLibrary

rtorrent

Download torrent files

TLDR

Add a torrent file or magnet to be downloaded

$ rtorrent [torrent_or_magnet]
copy

Start the download
$ <Ctrl s>
copy

View details about downloading torrent
$ <ArrowRight>
copy

Close rtorrent safely
$ <Ctrl q>
copy

SYNOPSIS

rtorrent [options] [torrent_file|magnet_link...]

PARAMETERS

-h | --help
    Display help message.

-v | --version
    Display version information.

-n | --no-check
    Disable checking of .torrent files.

-o | --output file
    Specify output file for a single torrent to download.

-d | --directory dir
    Set default download directory.

-s | --session dir
    Specify session directory.

-O | --load-start path
    Load and start torrents from the specified path.

-l | --load path
    Load torrents from the specified path.

-b | --bind ip
    Bind to a specific IP address.

-p | --port-range min-max
    Set port range for incoming connections.

-u | --upload-rate rate
    Set upload rate limit (in kB/s).

-D | --download-rate rate
    Set download rate limit (in kB/s).

DESCRIPTION

rtorrent is a command-line BitTorrent client written in C++, focusing on high performance and low resource usage.
It's designed to run on systems with limited resources, such as embedded devices and servers.
Unlike many GUI-based clients, rtorrent operates entirely from the terminal, allowing for efficient remote management and scripting.
It supports features like encryption, DHT, peer exchange (PEX), and magnet links. rtorrent can be controlled interactively via its interface or managed non-interactively through configuration files and command-line options.
Its configurability allows users to tailor its behavior to specific needs and network conditions, making it a popular choice for users who prioritize speed and efficiency.

CAVEATS

rtorrent's command-line interface can be challenging for new users. Configuration requires editing a configuration file, which may involve learning a specific syntax. Proper configuration is crucial for optimal performance and security.

CONFIGURATION FILE

rtorrent is primarily configured through a configuration file, typically named `.rtorrent.rc` in the user's home directory. This file allows for customizing various settings such as download directory, port range, rate limits, and tracker settings. The configuration file uses a Lisp-like syntax.

INTERACTION

Once rtorrent is running, you can interact with it by typing commands directly into the console. Commands allow you to start, stop, pause, and remove torrents, as well as view status information and change settings. Alternatively, you can use a dedicated front-end like rtgui or a web interface for remote control.

HISTORY

rtorrent development began in the early 2000s, aiming to create a lightweight and efficient BitTorrent client suitable for servers and embedded systems.
Its performance characteristics quickly gained popularity, leading to its adoption by users seeking a resource-friendly alternative to GUI-based clients.
Over the years, rtorrent has evolved with new features and optimizations, maintaining its focus on speed and minimal resource footprint.

SEE ALSO

screen(1), tmux(1), wget(1), curl(1)

Copied to clipboard