Setting up Aria2 with DuckieTV
This is a step by step guide on how to set-up Aria2 with DuckieTV.
This guide is based on my installation on the Windows 7 platform, but it should hold true across other platforms (more or less).
Aria2 1.35.0 or newer. Get the latest version at the official download site here
DuckieTV 1.1.5 or newer. Get the latest version at the official download site here
Dtv Nightly. Get the latest version at the official download site here
The Aria2 manual can be found at https://aria2.github.io/manual/en/html/aria2c.html#
Once you have installed Aria2, you will need to
- at the very minimum, you will need to enable the JSON-RPC service, and define the rpc-secret token so that DuckieTV can communicate with Aria2 and be authorised to issue commands.
Probably a good idea to set up the default download directory too.
For all the required settings for your platform, read https://aria2.github.io/manual/en/html/aria2c.html - an example of my test config on my Windows7:
# simple example of aria2 win7 configuration
# Enable the JSON-RPC server
enable-rpc=true
# Set the RPC secret authorization token, to authorise usage of rpc commands
rpc-secret=Your-RPC-secret-Token
# The default directory to store downloaded files
dir=c:/temp
An example of starting aria2 on windows with the config file
c:/programdata/aria2c/aria2c --conf-path=c:/home/garfield69/.aria2.conf
Once the program is running, you need to start up DuckieTV and
-
Start up DuckieTV and click on the Settings Icon
-
And then click on the Torrent button
-
Now click on the Aria2 button
-
Next, click on the Aria2 Integration button
-
Enter into the Token field the rpc-secret that you defined in the Aria2 config file
-
and if you are running Aria2 on a different computer than DuckieTV then enter its IP address in the Address box
-
Now click on the Test and Save button
-
You are connected!
If all went well, you should see a green dot next the the DuckieTV Aria2 Icon on the left hand side and a Status: Connected to Aria2 API on the right hand side.
Please note that being connected is not a guarantee that everything is operational. Some clients have further validation that only occurs during submissions of commands and requests for results.
- Did you get the Token on the DuckieTV Aria2 Integration panel wrong? When you press the Test and Save button, and the test fails, DuckieTV does not save the Token (or any other fields), so when you try again, you will need to enter both the new Token (and any other fields you previously changed) again.
- If you previously tried a connection and failed, and subsequently followed this guide and are still not connected, first try clicking on the DuckieTV Aria2 icon on the left. This will retry the connection attempt.
- If the connection is still not established, try closing both Aria2 and DuckieTV and starting them up again. Then click on the DuckieTV Aria2 icon to try establishing a connection.
- Could your local firewall or security app or router be blocking Dtv from accessing the inbound/outbound qBt port? Do you need to add a permission rule?
- Still not connected? If you are using DuckieTV as a Chrome Browser Extension, or as a Nightly Standalone, then you can check the DuckieTV console log for errors, by pressing the F12 key (on Windows and Linux) or Cmd-Alt-I (OSX) to open the development tools page, and clicking on the console tab to view the log.
and feel free to raise a ticket on GitHub here, or submit a post on Reddit here
and feel free to raise a ticket on GitHub