otty / dotfiles

All tools/aria2

aria2

aria2c

aria2 is a lightweight multi-protocol & multi-source, cross platform download utility operated in command-line.

Detected by aria2c | macOS, Linux, Windows |aria2.github.io

Sync it aria2c.toml

Sync rules

What travels, what stays, what never leaves

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

# aria2 configuration, legacy location: $HOME/.aria2/aria2.conf

dir=/Users/octocat/Downloadsmachine-local

input-file=/Users/octocat/.aria2/queue.txtmachine-local

continue=true

max-concurrent-downloads=5

max-connection-per-server=8

…

min-split-size=10M

file-allocation=falloc

ca-certificate=/Users/octocat/.aria2/ca-bundle.crtmachine-local

check-certificate=true

enable-rpc=true

…

Each machine keeps its own copy of these.

rpc-secretrpc-passwdftp-passwdhttp-passwd

Lifted into your secret store; the rest of the file syncs.

dirinput-fileca-certificate

Each machine keeps its own copy of these.

rpc-secretrpc-passwdftp-passwdhttp-passwd

Lifted into your secret store; the rest of the file syncs.

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

apps/aria2c.tomlThe file this page is generated from

id = "aria2c"

name = "aria2"

homepage = "https://aria2.github.io"

description = "aria2 is a lightweight multi-protocol & multi-source, cross platform download utility operated in command-line."

detect = ["aria2c"]

# aria2c(1), the --conf-path option

# (https://aria2.github.io/manual/en/html/aria2c.html): "Change the

# configuration file path to PATH. Default: $HOME/.aria2/aria2.conf if present,

# otherwise $XDG_CONFIG_HOME/aria2/aria2.conf". The same page's FILES section

# repeats it: the legacy path wins when it exists, and the XDG one is used

# otherwise — aria2 reads the variable, so that second location is

# [configHome]. Both are listed because which one a machine has depends on when

# the user first ran aria2. On Windows aria2 keeps to the $HOME/.aria2 form, so

# the [configHome] entry resolves to a file that is simply not there.

# The file is a NAME=VALUE list, one option per line, so the rules below are

# line oriented. The DHT routing tables ($XDG_CACHE_HOME/aria2/dht.dat and

# dht6.dat, or ~/.aria2/dht.dat) are state, not config; naming the two conf

# files rather than the directory leaves them out without needing an exclude.

paths = [

"~/.aria2/aria2.conf",

"[configHome]/aria2/aria2.conf",

]

exclude = []

# aria2.conf is not a whole-file secret: it is mostly connection limits, the

# download directory and RPC settings, all worth carrying. Only the credential

# options are lifted out, below.

secret = []

# The RPC and protocol passwords, in every shape aria2 has accepted them: the

# current --rpc-secret token, and --rpc-passwd, half of the older

# --rpc-user / --rpc-passwd pair the manual marks deprecated in favour of it

# but that aria2 still reads — plus the FTP and HTTP passwords. The matching

# `-user` options are left as ordinary config, the same way a user name stays

# with the config elsewhere in this catalog while only the secret half is

# lifted. Both spellings of the file, or the token is only lifted out on a

# machine that uses the XDG location and syncs in the clear from one that does

# not.

[[secret_paths]]

file = ["~/.aria2/aria2.conf", "[configHome]/aria2/aria2.conf"]

match = { prefix = ["rpc-secret", "rpc-passwd", "ftp-passwd", "http-passwd"] }

# `dir` is the absolute download directory, `input-file` the local URI list

# aria2 reads at startup, and `ca-certificate` a certificate bundle at a path

# that exists on this machine. All three name a location on one disk; carrying

# them to another machine points aria2 at directories and files that are not

# there. No other aria2 option name begins with any of these strings, so the

# prefixes catch nothing else. All three are the user's own: the download

# directory they picked, the queue file they wrote, and the certificate they

# were handed — `ca-certificate` appears at all only because the platform's own

# bundle was not the one to use. Kept so this machine can be set up the same

# way again: backup. Source as above.

[[machine_lines]]

file = ["~/.aria2/aria2.conf", "[configHome]/aria2/aria2.conf"]

match = { prefix = ["dir", "input-file", "ca-certificate"] }

scope = "backup"

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/aria2c. 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 dir and input-file for you — that part is Otty’s own sync, or a template you write by hand.