forum.utorrent.com

Links:
The WebUI Guide
The Readme

---

Installing default WebUI:
You can simply enable WebUI in the Preferences and µTorrent will automatically download and install the WebUI for you. Be sure to pick a username and password in the Preferences.
You might already have an older build of the webui on your machine. Currently there is no auto-update feature for the WebUI. To make sure you run the newest WebUI follow the update instructions below.

Updating to latest WebUI:
The latest version of WebUI can be found in this topic. It is has many bugfixes and added features. To install this download the file, rename it to webui.zip and place it in the same folder as where settings.dat is located.

By default settings.dat is located (after µtorrent has been started at least once) in %appdata%\utorrent but it might also be in %programfiles%\utorrent or %programfiles(x86)%\utorrent or where you manually installed utorrent.exe.

Accessing WebUI:
If you have a router you have to forward the port if you want to access your webui from elsewhere on the internet. Also with a router you often cannot use your Internet IP from machines in your LAN. For a detailed explanation of this look at this topic.

Connecting from a machine running µTorrent or machine in the same LAN:

1. Find your computer's IP by visiting Start > Run > cmd /k ipconfig. Look for the IP(v4)-address line. note: If there multiple such lines it is likely the IP that looks either like 192.168.x.x or 10.x.x.x and it is often listed under the first Ethernet adapter.
   
2. Find µTorrent port in the Connection preferences (or the WebUI alternative listening port, if enabled)
   
3. In your web browser, visit http://your ip:your port/gui/ (for example, http://192.168.1.2:63421/gui/)
   

Connecting from another machine elsewhere on the Internet:

1. Find your computer's IP by visiting WhatIsMyIP.com.
   
2. Find µTorrent port in the Connection preferences (or the WebUI alternative listening port, if enabled)
   
3. In your web browser, visit http://your ip:your port/gui/ (for example, http://12.34.56.78:12345/gui/)
   

---

Common Problems:

• I have a dynamic IP address -- Read this topic carefully.
  
• The webui displays but my detail/category/etc pane is gone or is displaying incorrectly -- Press Esc to reset the interface.
  
• I only see the text invalid request -- Usually forgot or mistyped /gui/ or used µTorrent port instead of alternate port. See this post for more information.
  
• I get a Blank Screen -- Update µTorrent itself (and get the newest version of WebUI).
  
• Page stuck on Loading... -- Update µTorrent itself (and get the newest version of WebUI). If it still happens it is either an unsupported browser or JavaScript related. See this topic for more information and help.
  
• Weird page with a line of gibberish, a line with Loading... and then a weird form. -- This problem can have various (sometimes elusive) causes. See this topic for things to try and further help.
  

---

Community Projects:
Outdated projects have been moved here.

Popular:

• µRemote
  Independent Application with systray icon and lots of features.
  (no GUID cookie support)
  
  
• µTorrent MiniUI
  Alternative UI that works across a variety of platforms, designed mainly for browsers on mobile devices with AJAX support.
  
  
• Multi-user Webui Shell
  Independent Application that allows one to setup multiple users and allow/disallow certain actions (requires a web server).
  (GUID cookie support in WIP, but not in stable)
  
  
• uTorrent Mobile
  Independent Application for mobile phones with mobile Java support.
  (no GUID cookie support)
  

Alternative UI: (inserted into or replaces webui.zip)

• Adobe AIR
  An Adobe AIR application to control µTorrent.
  (no GUID cookie support)
  
  
• iPad UI by Fijian Warrior
  An alternative UI made for the Apple iPad.
  (untested*)
  
  
• iPhone UI by Fijian Warrior
  An alternative UI made for the Apple iPhone (based on davidraso's iPhone UI).
  
  
• iPhone UI by andree-w
  An alternative UI made for the Apple iPhone (based on davidraso's iPhone UI).
  
  
• iPhone UI by davidraso
  An alternative UI made for the Apple iPhone.
  
  
• iPhone UI by Squiggs
  An alternative UI made for the Apple iPhone.
  
  
• µTorrent Web UI for iPhone
  Another webui aimed at the iPhone. It has a handy installer that injects the interface into your current webui.zip making it easy to combine with other UIs.
  
  
• Terminal Skin
  Regular Webui with a different skin.
  (no GUID cookie support)
  
  
• Drag and Drop Add URL
  Drag and drop a url link onto the webUI and it automatically uploads the torrent.
  (untested*)
  

Independent Application: (does not load webui.zip from µTorrent)

• Transdroid
  An application for Google Android based phones.
  
  
• Torrent-fu (external link)
  Google Android app to search and to remote control µTorrent (and Transmission).
  (untested*)
  
  
• µMonitor
  An (jailbroken) iPhone application.
  

Independent Window: (loads webui.zip from µTorrent outside of a browser window).

• Speed Controller
  View torrents and change the global speeds.
  

Gadgets/Plugins:

• Apache ReverseProxy
  Shows the the WebUI on your Apache web server on a different port from the listening port.
  
  
• Apache VirtualHost with Rewriter
  Shows the WebUI on a subdomain of your Apache web server.
  
  
• Chrome Extension
  Adds a µTorrent GUI to Google Chrome.
  
  
• Firefox Extension
  Adds a µTorrent Sidebar to Firefox.
  
  
• Google Desktop
  Gadget for the Google Desktop sidebar.
  (read only because of broken token support)
  
  
• mIRC script
  Script for mIRC to report various µTorrent stats in a channel.
  
  
• Move unlisted
  Moves the data of removed (completed) torrents to a specified folder.
  
  
• tSpeed
  Application that shows µTorrent transfer speeds in taskbar.
  (no GUID cookie support)
  
  
• Windows Desktop/Sidebar Gadget
  Gadget for the Windows Sidebar.
  
  
• XBMC WebUI Controller Plugin
  A plugin for XMBC that allows you to manage µTorrent.
  
  
• XBMC The Pirate bay scraper Plugin
  A plugin for XMBC that allows you to search for torrents and add them.
  (untested*)
  
  
• uTorrent regulator
  Regulates uTorrent Global upload and download speeds on the basis of the number of computers connected to the local network.
  (untested*)
  

Torrent Adder:

• µTorrent Adder
  Remotely add .torrent files to µTorrent, either from within the utility or by .torrent file association.
  
  
• pyuTorrent
  Cross platform (incl. linux) app to send .torrents and magnet links to µTorrent.
  (untested*)
  
  
• Firefox Extension
  To add a "Send to WebUI" option to the context-menu hyperlinks.
  

* untested only means that the maintainers of this thread have not tested the application yet

---

For Developers:
API: Description of all queries.

• .NET: Library for .NET Framework 3.5 SP1 & WCF bindings
  
• Java How to query µTorrent
  
• mIRC: Usable example script
  
• PHP: Usable class
  

Other dev notes:

• Make sure you support token authentication! In the current version of µTorrent token authentication is required by default. Projects that do not support this will only be listed in the Outdated Projects topic.
  
• From µTorrent 2.1 on these tokens will be bound to a single session which is identified by a GUID cookie. Info on how to implement this see can be found in this post.
  
• Just a friendly warning: Apple's AppStore has a policy of rejecting BitTorrent-related apps, including remote control apps. Only jailbroken iPhone/iPod users will be able to use any native applications you write for the iPhone/iPod. See also:
  - Apple rejects BitTorrent control app Drivetrain (iLounge, TorrentFreak)
  - Apple forces Trackr to drop torrent features retroactively, after having already accepted the app (iLounge)
  - uTorrent iPhone App Rejected by Apple, Goes Underground (TorrentFreak)
  

---

If you think anything needs to be added please tell us.
Off-topic posts in this thread will be ignored and probably deleted.

Last edited by Lord Alderaan (2010-07-26 02:24:30)