aria

Friendly aria2c wrapper for your personal downloads.
Quick, simple, enjoyable.

aria wraps the JSONRPC server of the great aria2, exposing just enough functionality to be dangerous.

Installation

Build and install the binary and man page to $(PREFIX)/bin and $(PREFIX)/share/man/man1 (defaults to ~/.local):

make install

To install elsewhere, override PREFIX:

make install PREFIX=/usr/local

To remove:

make uninstall

Note

Make sure $(PREFIX)/bin is in your PATH to run aria from anywhere.

Features

One command for everything

Add, pause, resume, and remove downloads with a unified API — no more memorising cryptic flags:

aria add https://example.com/file.iso
aria add uri https://example.com/file.iso
aria add torrent https://example.com/linux.torrent
aria pause 8a4c3f21e09b7d55
aria resume 8a4c3f21e09b7d55
aria remove 8a4c3f21e09b7d55
aria purge

Commands without arguments act on all downloads, so you can pause or resume everything at once:

aria pause
aria resume

Interactive list

Run aria list to check the status of all your downloads in a beautifully formatted table, live-refreshing every second:

aria list

Pick a download with the arrow keys and enter, and its GID is printed to stdout, ready to be composed with any other tool:

aria pause "$(aria list)"

Options

Every command supports a couple of well-chosen options, and nothing more:

Option	Description	Default
`-d`, `--directory <dir>`	Define the directory to save files.	`~/Downloads/`
`--seed`	Enable seeding after torrent download.

Simple configuration

Point aria to your aria2c server by directly editing the source:

enum Config {
	static let host: String = "127.0.0.1"
	static let port: Int = 6800
	static let secret: String = "my_secret"
	static var endpoint: URL {
		URL(string: "http://\(host):\(port)/jsonrpc")!
	}
	static let directory: String = "~/Downloads/"
}

2.5 KiB Raw Permalink Blame History