µTorrent, a highly efficient and feature-filled BitTorrent Client.

A guide to the µTorrent WebUI


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)

  • Open µTorrent and go to the WebUI settings (Preferences -> Advanced -> Web UI)
  • 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)
  • 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
  • Now you'll have to install Stunnel. You can get the latest version from their website (http://www.stunnel.org/download/binaries.html)
  • After installing Stunnel, open up the stunnel.conf file
  • Under the "; Service-level configuration" comment you can remove all settings except from the "[https]" setting
  • Uncomment the "[https]" setting by removing the semi-colons in front of each line. You may change "https" to "webui" if you'd like
  • 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)
  • The "connect" setting should be changed to the port that you entered as the alternative listening port in µTorrent
  • Start Stunnel, open up your browser, and navigate to https://ip:[Stunnel accept port]/gui/