What is the aria2 –lowest-speed-limit Setting?

The --lowest-speed-limit option in aria2 is a command-line configuration used to manage and optimize download efficiency. It sets a minimum threshold for download speeds, allowing aria2 to automatically drop slow or stalled connections and switch to faster alternatives. This article explores how this setting works, why it is beneficial for large or multi-connection downloads, and how to configure it effectively in your command-line environment.

How the Lowest Speed Limit Setting Works

When you download a file using aria2, the client often splits the download across multiple connections or mirrors to maximize bandwidth. However, some servers or peers may provide incredibly slow transfer speeds, which can bottleneck the overall download process or waste system resources.

By using the --lowest-speed-limit setting, you define a strict baseline speed. If the average download speed of a connection drops below this specified limit for a set period, aria2 will actively terminate that specific connection.

Key Benefits of Configuring a Minimum Speed

Syntax and Implementation

To implement this setting, you must specify a speed value, which typically defaults to bytes per second unless a unit modifier like K (Kilobytes) or M (Megabytes) is appended.

aria2c --lowest-speed-limit=50K https://example.com/file.zip

In this example, if the download speed falls below 50 Kilobytes per second, aria2 will close the connection.

Important Pairing: The Timeout Dependency

The --lowest-speed-limit setting does not act instantly the moment a speed dips. It works in tandem with another crucial setting: --max-download-limit or, more specifically, the connection timeout controls.

By default, aria2 looks at the average speed over a period of time (usually 60 seconds) before deciding to drop the connection. If you want to change how long aria2 waits before cutting off a slow connection, you should configure it alongside the timeout settings to ensure your download queue moves as efficiently as possible.