Setting up uTorrent API with DuckieTV

This is a step by step guide on how to set up DuckieTV to connect with the API of µTorrent.

---

ALERT

As of µTorrent version 3.5.3 DuckieTV can no longer connect via this API by default. You will first have to enable port 10000 on your µTorrent app's WEBUI settings page, because of security changes that the BitTorrent team have made.
Or you could switch to using the DuckieTV WEBUI integration. Read this guide.

---

Note: DuckieTV can only connect with the API of the Windows version of µTorrent.
Tests performed on other platform's µTorrent (OSX, Linux, Android) have been unsuccessful so far. Sorry.

Note 2: The API only works if µTorrent is running on the same computer as DuckieTV.

But don't despair. If you are using OSX, Linux, Android, or have µTorrent running on another computer, then you can still connect your DuckieTV with µTorrent by using the WEB UI. Read this guide.

This guide is based on my Windows 7 platform, but it should hold true across the other Windows platforms (more or less).

Pre requisites:

Windows µTorrent 3.3.0 or newer. Get the latest version at the official download site here

DuckieTV 1.1.2 or newer. Get the latest version at the official download site here
Dtv Nightly. Get the latest version at the official download site here

Documents

Support for uTorrent can be found at http://help.utorrent.com/

---

configure µTorrent 3.3.0 to 3.5.2

• there is no special configuration required. Once you have installed µTorrent, start it up.

configure µTorrent 3.5.3 and newer

• Click on the Options menu entry and select Preferences
  

• Now click on Advanced to expand the list
  

• And then click on Web UI to bring up its configuration panel
  

• Click on the Enable Web UI check box
  

• Next, enable the Alternative Listening Port by clicking on the check box, and set the port to 10000.
  

• Now click on the Apply and OK buttons to save your settings.
  

Start up DuckieTV and

connect DuckieTV with µTorrent.

• Start up DuckieTV and click on the µTorrent Icon

• click on the Yes button of the µTorrent allow access dialogue.
  

• you are connected! If all went well, you should see a green dot next to the µTorrent Icon on the left hand side.

Problems?

• Sometimes, the authorisation token that DuckieTV needs to issue commands to µTorrent expires, or is invalidated, as can happen for instance, after µTorrent has performed a program upgrade. To fix this you can

  • Click on the µTorrent Icon
    
  • and then click on the Clear µTorrent Authorisation button.
    
  • this will delete the old authorisation and request a new one. When you get the µTorrent allow access dialogue, click the Yes button to establish a new authorised connection.
    

• Not connecting yet? Try shutting down DuckieTV and starting it up 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? 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