Documentation

Important links

Installation

  • To install the WebUI, after configuring it with the instructions in the section below, simply visit the WebUI URL in your browser (http://yourip:yourport/gui/ ) and µTorrent will download it automatically.
  • To install manually or upgrade to a newer version, visit the forum thread linked above for the download link to the latest version. After downloading, rename the file to "webui.zip" and place it in %AppData%\uTorrent (Paste this path into the Explorer address bar).
  • If running µTorrent in portable mode, place it in the same folder as the .dat files

How to use the WebUI

  • Enable and configure the WebUI in µTorrent (Preferences -> Advanced -> WebUI)
  • If using the alternate port function, you must allow it in your firewall and forward the port in your router. If using UPnP, µTorrent will automatically forward the WebUI port.
  • Open up a supported browser and use the following URL format: http://YourIP:UTport/gui/
  • If the browser supports Username:Password (and you have the WebUI working with the first URL) then use the following URL format: http://Username:Password@YourIP:UTport/gui/

N.B: When using the WebUI locally use localhost or 127.0.0.1 as using your external (WAN) IP may cause problems when behind a router.

Freeze on loading or garbage data displayed?

There are several things to try.

  • First try pressing CTRL+F5 in your browser. This will either revive the WebUI, or you will see a blank (white) screen. If you only see a blank (white) screen then close and reopen the browser then load WebUI again.
  • If that doesn't work then use the following URL http://YourIP:UTport/gui/?action=setsetting&s=webui.cookie&v={} and then reload the WebUI using the normal URL.
  • If garbage data is displayed, make sure that your WebUI.zip is the correct size. You may want to try redownloading it and ensure the download was completed successfully.
  • If nothing works, then please come to http://forum.utorrent.com/ or irc://irc.utorrent.com/utorrent-webui to ask for help.

Notes

Keyboard Shortcuts

  • Ctrl + A: Select all rows (select a row in the list first)
  • Ctrl + O: Show the form for adding a torrent
  • Ctrl + P: Show the settings window
  • Ctrl + Z: Deselect All
  • Del: Remove torrent
  • F2: Show the about window
  • F4: Hide/show the toolbar
  • F6: Hide/show the details pane
  • F7: Hide/show the category list

Running the WebUI over HTTPS (SSL)

  1. Open µTorrent and go to the WebUI settings (Preferences -> Advanced -> Web UI)
  2. Enable the "Alternative listening port" and change it to any port that you want (this port should not be forwarded in your firewall and/or router)
  3. In the "Restrict access to the following IPs" enter "127.0.0.1" (without quotes). This is basically to prevent anybody from accessing the WebUI over HTTP
  4. Now you'll have to install Stunnel. You can get the latest version from their website (http://www.stunnel.org/download/binaries.html)
  5. After installing Stunnel, open up the stunnel.conf file
  6. Under the "; Service-level configuration" comment you can remove all settings except from the "[https]" setting
  7. Uncomment the "[https]" setting by removing the semi-colons in front of each line. You may change "https" to "webui" if you'd like
  8. The "accept" setting is the port which a browser will try to connect to. So, this is the port that you will have to forward in your firewall and/or router (443 is the default SSL port, but it can changed)
  9. The "connect" setting should be changed to the port that you entered as the alternative listening port in µTorrent
  10. Start Stunnel, open up your browser, and navigate to https://ip:[Stunnel accept port]/gui/