How to Format Console Output in aria2?

This article provides a quick overview of how to customize and control the console output format in the aria2 download utility. It covers the specific command-line parameter required to change the log and console styles, explains the available formatting options, and provides practical examples to help you optimize your terminal interface.

The Console Output Parameter: --console-log-level and --summary-interval

While aria2 does not have a single “theme” parameter to completely redesign the console UI, it provides specific parameters to control what information is displayed on the console and how frequently it updates.

The primary parameter used to control the verbosity of the console output is:

--console-log-level

This parameter determines the minimum log level to output to the console. By managing this, you can keep your terminal clean or get highly detailed real-time data.

Available Log Levels

You can assign the following values to the --console-log-level parameter:

• debug: Displays all messages, including extensive internal debugging information.
• info: Displays standard informational messages, such as download starts and completions.
• notice: Displays important structural notices (this is the default setting).
• warn: Displays only warnings and errors.
• error: Restricts the output entirely to critical execution errors.

Controlling Update Frequency

To change how the actual download progress looks and behaves on your screen, you couple the log level with the summary interval parameter:

--summary-interval=<SEC>

This defines the number of seconds between the printing of the download progress summary. Setting this to 0 suppresses the progress summary entirely, which is ideal for clean logging environments or automated scripts.

Modifying the Download Progress Interface

If you want to alter the actual visual structure of the progress bar in the console, you must use the status parameter:

--show-console-readout

By setting this parameter to true or false, you can toggle whether aria2 displays the real-time download speed, progress percentage, and estimated time of completion (ETA) at the bottom of the terminal window.