otty / dotfiles

All tools/rTorrent

rTorrent

rtorrent

A ncurses-based command line torrent client for high performance.

Detected by rtorrent | macOS, Linux |github.com

Sync it rtorrent.toml

Sync rules

What travels, what stays, what never leaves

rTorrent in your home directory Every rule on this page, by file

session.path.setdirectory.default.setnetwork.listen.port.range.setnetwork.scgi.open_localsession directory port_range

Each machine keeps its own copy of these.

…

# forms appear here; a real file uses one set or the other.

# --- paths and ports that belong to this machine --------------------------

session.path.set = /Users/octocat/.local/share/rtorrent/sessionmachine-local

directory.default.set = /Volumes/media/downloadsmachine-local

network.listen.port.range.set = 50000-50000machine-local

network.scgi.open_local = /Users/octocat/.local/share/rtorrent/rtorrent.sockmachine-local

# Pre-0.9 spellings of the same three options.

session = /Users/octocat/.rtorrent-sessionmachine-local

directory = /Volumes/media/downloadsmachine-local

port_range = 50000-50000machine-local

# --- preferences ----------------------------------------------------------

throttle.global_down.max_rate.set_kb = 4000

…

Each machine keeps its own copy of these.

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/rtorrent.tomlThe file this page is generated from

id = "rtorrent"

name = "rTorrent"

homepage = "https://github.com/rakshasa/rtorrent"

description = "A ncurses-based command line torrent client for high performance."

detect = ["rtorrent"]

platforms = ["macos", "linux"]

# src/setup.cc walks a three-step search and stops at the first file that

# exists:

# $XDG_CONFIG_HOME/rtorrent/rtorrent.rc (only when the variable is absolute)

# $HOME/.config/rtorrent/rtorrent.rc

# $HOME/.rtorrent.rc

# The first two are one location — $XDG_CONFIG_HOME with ~/.config as the

# fallback — which is what [configHome] means. The third is the pre-XDG spelling

# and is still what most existing setups use; rtorrent(1) refers to it directly

# under -n, "Don't load ~/.rtorrent.rc on startup". Both are listed and a

# consumer skips whichever is not on disk.

paths = [

"[configHome]/rtorrent/rtorrent.rc",

"~/.rtorrent.rc",

]

exclude = []

# No credential file. Tracker passkeys live inside .torrent files in the session

# directory, which is not synced.

secret = []

# Absolute paths and a listening port, all decided by the machine rTorrent runs

# on. doc/rtorrent.rc-example writes the modern command names —

# `session.path.set = (cat, (cfg.session))`, `directory.default.set = (cat,

# (cfg.download))`, `network.listen.port.range.set = 50000-50000` and

# `network.scgi.open_local = (cat,(session.path),rtorrent.sock)` — while

# rtorrent(1) documents the short forms the same three options had before 0.9:

# "session = directory", "directory = directory", "port_range = a-b". Both

# spellings are listed because a given file uses one or the other.

# The legacy prefixes carry the trailing space on purpose. A prefix is a plain

# string match against the line, so a bare "session" would also swallow

# "session_on_completion" and "session.on_completion.set", which are

# preferences rather than paths; "session " stops at the assignment the man page

# writes.

# Everything else in the file — throttle limits, ratio rules, the interface

# layout — is the user's setup and travels.

[[machine_lines]]

file = ["[configHome]/rtorrent/rtorrent.rc", "~/.rtorrent.rc"]

scope = "backup"

match = { prefix = [

"session.path.set",

"directory.default.set",

"network.listen.port.range.set",

"network.scgi.open_local",

"session ",

"directory ",

"port_range ",

] }

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/rtorrent. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page. None of them splits session.path.set and directory.default.set for you — that part is Otty’s own sync, or a template you write by hand.