Aria2 RPC CLI (a2rpc)

A lightweight Python CLI tool to interact with aria2c's JSON-RPC interface, designed for scripting and automation.

Features ✨

• 📥 Download Management
  Add, pause, resume, or remove downloads via HTTP, Magnet, or torrent links.
• 🖥️ Server Control
  Start/shutdown aria2c RPC server with custom ports and directories.
• 📋 Batch Processing
  Queue multiple downloads from input files with per-URL options.
• 📊 Real-Time Monitoring
  List active/waiting/stopped downloads with debug-friendly output.
• 🔒 Secure
  Supports RPC secret tokens for authenticated access.

☕ Support

If you find this project helpful, consider supporting me:

Installation

Prerequisites

• aria2c installed (Download aria2)

Via pip

pip install a2rpc

Manual

git clone https://github.com/jet-logic/a2rpc
cd a2rpc
pip install .

Usage

Basic Commands

Advanced: Batch Downloads

1. Create an input file (downloads.txt):

   https://example.com/file1.iso
       dir=/mnt/downloads
   https://example.com/file2.zip
       out=backup.zip
   

2. Run:

   a2rpc input downloads.txt
   

Configuration

Global Flags

Example:

a2rpc --rpc-secret mytoken add "https://example.com/large-file.mp4"

Examples

1. Download with Custom Options

a2rpc add "https://ubuntu.com/24.04.iso" \
  --dir ~/Downloads \
  --out ubuntu-latest.iso \
  -s "max-connection-per-server=16"

2. Debug Active Downloads

a2rpc list --debug  # Shows detailed YAML output

3. Automate with Scripts

import subprocess
subprocess.run(["a2rpc", "add", "magnet:?xt=..."])