Monitor aria2c Download Progress in Real-Time on Ubuntu

This guide explains how to track download status when using the aria2c command-line utility on Ubuntu. You will learn how to enable real-time status updates directly in the terminal and how to use the built-in RPC interface for detailed monitoring. By following these steps, you can manage large file transfers efficiently without losing visibility into speed, completion percentage, and estimated time remaining.

Install aria2 on Ubuntu

Before monitoring downloads, ensure the tool is installed on your system. Open your terminal and update your package list, then install aria2 using the following commands:

sudo apt update
sudo apt install aria2

Use Default Console Output

When running aria2c interactively in the terminal, it displays a real-time console UI by default. This interface shows the download progress, speed, ETA, and peer information automatically. To start a download with this visible progress bar, simply run:

aria2c https://example.com/file.zip

The terminal will update dynamically until the download completes. Do not use the -d (daemon) flag if you want to see this immediate output in the current session.

Adjust Summary Intervals

If you prefer a text-based summary rather than the dynamic UI, or if you want to control how often the status updates, use the summary interval flag. This is useful for logging or reducing terminal flicker. Set the interval to one second for near real-time feedback:

aria2c --summary-interval=1 https://example.com/file.zip

This command forces aria2c to print a status summary every second instead of the default ten seconds.

Monitor Background Downloads with RPC

To monitor downloads running in the background or within a script, enable the RPC interface. This allows external tools to query the download status. Start aria2c with RPC enabled:

aria2c --enable-rpc --rpc-listen-all=true --rpc-allow-origin-all

Once running, you can use a third-party monitoring tool like aria2mon or send JSON-RPC requests to check progress. For a simple CLI check without extra tools, you can view the session file if configured, but using an RPC client provides the most accurate real-time data for background tasks.