Skip to content

Setting up qBitTorrent with DuckieTV

Jump to bottom Edit New page
garfield69 edited this page Dec 3, 2024 · 11 revisions

This is a step by step guide on how to set up qBitTorrent 4.1+ with DuckieTV. If you are using a version of qBitTorrent prior to 4.1, then you are out of luck, DuckieTV starting with nightly-202412031757 no longer supports these old versions. This guide is based on my installation on a Windows 7 platform, but this guide should hold true across the other platforms (more or less).

Pre requisites:

qBitTorrent 4.1 or newer. Get the latest version at the official download site here

Dtv nightly-202412031757 or newer. Get the latest version at the official download site here

Documents

The wiki for qBt can be found at https://github.com/qbittorrent/qBittorrent/wiki

Note: While the pictures are from the 3.2 versions, they still apply to the 4.1+ so I have not bothered to update them. Just treat any references in the pictures for 3.2 as 4.1 ;-)

Once you have installed and started qBitTorrent, we can

access the Web UI configuration page.

  • Click on the Tools menu, and select the Options entry

  • Click on the Web UI Icon

  • Enable the Web UI Interface by clicking the check-box and enter a Username and Password

  • Un-check the Enable Cross-Site Request Forgery (CSRF) protection checkbox

  • HTTPS connections are currently not supported.

  • Click the Apply and OK buttons

Start up DuckieTV and

configure the DuckieTV qBitTorrent 4.1+ Integration.

  • Start up DuckieTV and click on the Settings Icon

  • Click on the Torrent button

  • Click on the qBitTorrent 4.1+ button

  • Click on the qBitTorrent 4.1+ integration button

  • Enter the same username and password that you used on qBitTorrent

  • if you are running qBitTorrent on a different computer than DuckieTV then enter its ip address in the Address box

  • Click on the Test and Save button

  • You are connected!

If all went well, you should see a green dot next to the DuckieTV qBitTorrent Icon on the left hand side
and a Status: Connected to qBitTorrent 4.1+ 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.

Gotcha

DuckieTV polls qBitTorrent every 3 seconds to fetch the download status. If you are using qBt Seeding Limit option to remove the torrent, then do not set the trigger too low, or you may end up removing the torrent from qBt before Dtv has had a chance to see the download reach 100%. If Dtv thinks the torrent has vanished it will flag the download as lost and not mark the episode as downloaded.

Problems?

  • Did you get the username or password on the DuckieTV qBitTorrent 4.1+ Integration panel wrong?
    When you press the Test and Save button, and the test fails, DuckieTV does not save the username and password (or any of the other fields), so when you try again, you will need to enter both the new username and password (and any other fields you changed previously) again.
  • did you remember to un-check the enable Cross-Site Request Forgery Protection check-box on the qBt app, Options, WEB UI configuration panel?
  • If you previously tried a connection and failed, and subsequently followed this guide and are still not connected, first try clicking on the DuckieTV qBitTorrent 4.1+ icon on the left. This will retry the connection attempt.
  • If the connection is still not established, try closing both qBitTorrent 4.1+ and DuckieTV and starting them up again. Then wait and look at the DuckieTV qBitTorrent 4.1+ icon. The Icon's Red dot should change to Orange and then Green when the connection is completed.
  • Did you recently upgrade qBt to a new version?
    Sometime the new releases require you to re-enter and save the apps' webui password, as the new version may change the encryption method. So save the qBt apps' webui password one more time, exit and restart the qBt app, start Dtv and try again.
  • 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? See if you can connect and login to the qBitTorrent 4.1+ WEBUI directly via your Browser. for example, at the address box paste http://localhost:8080 and press enter. You should get the Login challenge followed by the qBitTorrent 4.1+ torrent page if successful. If this does not work then you know the problem is with your qBitTorrent 4.1+ setup or with some system setup, such as firewall or antivirus or network or something.
  • 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
  • If you are running an alternate WebUI theme, turn it off. It may be interfering. DTV's qBt integration is dependant on APIv2 using the standard qBt WEBUI interface. If the alternative WebUI differs in any way from the standard command paths or results structures, then DTV will not be able to talk to it.
Add a custom footer

Navigation

Clone this wiki locally