commands.page Website Logo

  • Home
  • Categories
  • Search

How to Download a Torrent from the Internet Using Aria2 on Ubuntu Terminal

This is an article about downloading torrents using Aria2, a lightweight command-line download utility that supports HTTP, FTP, and BitTorrent. In this guide, we will walk through the steps needed to set up Aria2 on your Ubuntu system and how you can use it efficiently for torrent downloads directly from the terminal.

In this article, you will find information about installing and configuring Aria2, setting up a session file (RPC), downloading torrents via command-line arguments or configuration files, handling multiple torrent downloads simultaneously, and managing and monitoring downloads using XML-RPC. The guide also includes troubleshooting tips and security considerations related to BitTorrent downloads.

Read this article to find out how you can leverage the flexibility of Aria2 for your torrenting needs without needing a graphical interface, making it particularly useful for server environments or headless setups.

Introduction to Aria2

Aria2 is an open-source lightweight cross-platform command-line download utility that supports HTTP, FTP, and BitTorrent. One of its key features is its ability to split files into smaller chunks, allowing simultaneous downloading from multiple sources, which significantly increases download speeds compared to traditional single-threaded downloads.

For users who prefer the terminal over graphical interfaces or those managing headless servers, Aria2 offers a powerful alternative for downloading torrents and other file types. It supports multi-protocol and multi-source downloads, meaning you can combine different protocols (e.g., HTTP and BitTorrent) in a single download task.

Installing Aria2 on Ubuntu

Before we delve into configuring and using Aria2, let’s cover the installation process on an Ubuntu system.

Step 1: Update Your System

First, update your package lists to ensure that all software repositories are up-to-date:

sudo apt-get update

Step 2: Install Aria2

You can install Aria2 using the following command:

sudo apt-get install aria2 -y

After installation is complete, you should see confirmation messages indicating that Aria2 has been successfully installed.

Configuring Aria2 for Torrent Downloads

To start downloading torrents with Aria2, we first need to configure it properly. We will set up an RPC session (Remote Procedure Call) to interact with Aria2 via command-line arguments or configuration files.

Step 1: Create a Configuration File

Create a file named aria2.conf in your home directory for storing the configuration settings:

nano ~/.aria2/aria2.conf

You can create the .aria2 directory if it doesn’t already exist and copy this default config template into it.

Step 2: Add Basic Configuration Settings

Here are some essential configurations to add in aria2.conf for torrent downloads:

# Set the path of download directory (default is current directory) dir=/home/user/Downloads # Set a file containing the RPC secret token, used with --rpc-secret option. If this option is specified, it will be automatically read when --enable-rpc is set. rpc-secrets-file=~/.aria2/secret.txt # Enable RPC and specify listening port (default 6800) enable-rpc=true rpc-listen-port=6881

Step 3: Create a Secret File

Create the secret.txt file as specified in your configuration:

echo "your_secret_token" > ~/.aria2/secret.txt chmod 600 ~/.aria2/secret.txt

Replace "your_secret_token" with a strong, unique secret.

Starting Aria2

After configuring your settings, you can start Aria2 using the following command:

aria2c --conf-path=~/.aria2/aria2.conf

You should see messages indicating that Aria2 is running and accepting RPC commands.

Downloading Torrents with Aria2

Method 1: Using Magnet Links

To start a torrent download using its magnet link, simply use the following command:

aria2c <magnet_link>

For example:

aria2c "magnet:?xt=urn:btih:4B059480D7C6FEC32A1EBEBA53EAB1A7656BCC"

Method 2: Using .torrent Files

If you have a .torrent file, download it and specify its location:

aria2c --seed-time=0 /path/to/torrent_file.torrent

The --seed-time option specifies how long the client will continue to seed after downloading the torrent.

Managing Multiple Torrents

To manage multiple torrents, you can use a single command with multiple URLs or magnet links:

aria2c url1 [url2] [magnet_link]

Alternatively, you can start multiple instances of Aria2 and specify different configuration files for each instance. This method is useful if you want to keep downloads separate based on categories or sources.

Using XML-RPC with Aria2

To manage your downloads more efficiently and interact with Aria2 programmatically, consider using its built-in support for XML-RPC:

  1. Start Aria2 with the RPC enabled.

    aria2c --enable-rpc=true --rpc-listen-port=6800 --conf-path=~/.aria2/aria2.conf
  2. Use any tool or script that supports XML-RPC to send commands like system.multicall to start, pause, remove torrents, etc.

  3. Refer to the official Aria2 documentation for details on available methods and how they are invoked via RPC calls.

Monitoring Downloads

To monitor your downloads without opening a web browser, you can use various command-line tools or scripts that query Aria2’s XML-RPC interface. For instance:

curl -X POST --data-binary @- http://localhost:6800/jsonrpc -H 'Content-Type: application/json' <<EOF {"jsonrpc":"2.0","id":"qwer","method":"aria2.tellActive"} EOF

This command queries the active download status.

Troubleshooting Tips

  1. Check Firewall Settings: Ensure that Aria2’s RPC port (6800 or configured port) is open and not blocked by your firewall.

  2. Inspect Log Files: Use aria2c --log=~/aria2.log to log debugging information which can help identify issues.

  3. Update Configuration File: Always review the latest Aria2 configuration options in its documentation for any updates or new features that might be relevant to troubleshooting problems.

Security Considerations

While BitTorrent offers a decentralized method of file sharing, it also introduces security concerns such as exposure to malicious content and potential legal liabilities (due diligence is advised). Additionally:

  • Use Strong RPC Secrets: Keep your secret token secure by making sure the rpc-secrets-file has appropriate permissions.

  • Monitor Torrent Activity: Regularly check what files are being downloaded or seeded via Aria2.

Conclusion

Using Aria2 for downloading torrents from the internet provides you with a flexible and powerful tool that can be managed entirely through command-line interfaces. Whether you prefer to run it on your desktop, laptop, or even in server environments without a graphical interface, Aria2’s efficiency and robust feature set make it an excellent choice.

With the steps outlined above, you should now have a solid foundation for setting up and managing torrent downloads using Aria2 on Ubuntu terminal. Continue exploring its extensive command-line options and configuration possibilities to further customize your download experience.

Last Modified: 26/05/2019 - 02:08:40