Getting Started

Installation (OS X)

• Download Clutch.app from here.
• Unzip.
• Copy Clutch to your Applications folder.
• Done!

Starting Clutch (OS X)

• Start Transmission.app and Clutch.app (you can start them in either order, but the WebUI won't be available until both are running).
• Clutch will put a new menu item in your top menu bar. All the relevant server-side options can be set here :
  
• Select Open URL to open up the Clutch WebUI in your browser. If your browser can't display the page, your ports may be blocked - try changing the IP address in the address bar to http://127.0.0.1:9091/ .
• If you want to alter any of the settings, there are various preferences available from the menu :
  
  
  

Installation (Linux)

• You will need a few things installed first, notably :
  • A web server running PHP5.2+ (Apache & lighttpd have been tested but any php5.2+-capable webserver should work)
  • The JSON extension for PHP
  • The socket extension for PHP
  • Transmission Daemon (there are various packages floating around for different linux distributions, or alternatively you can build it yourself)
• Download the Clutch Web UI bundle, unpack it and put it somewhere inside your web server's document root (for example in /var/www/clutch for a typical Ubuntu installation).
• Edit the remote/data/socket.txt file in your WebUI folder, making sure it points to the location of your transmission-daemon socket file (this can vary depending on your linux distribution and the package you installed - for ubuntu the default location is /home/<your user name>/.transmission/daemon/socket).
• Make sure the socket file is readable and writable by the web server (chmod -R 777 ~/.transmission/daemon/socket for Ubuntu - the location may vary with other distributions).
• Make sure the remote/data/ folder and it's contents are readable and writable by the web server (chmod -R 777 /var/www/clutch/remote/data). Your preferences will be stored here.
• Make sure the folder you intend to download to is readable and writable by the web server (chmod -R 777 path/to/your/download/folder/).

If you are after more detailed instructions, there are a couple of nice walk-throughs available :

Installing Transmission with Clutch WebUI

Transmission Clutch HowTo

There is an Ubuntu package in the works as well which will allow 1-click install for Ubuntu users - more details as they emerge.

Starting Clutch (Linux)

• Start the daemon and web server up and navigate to the location where you installed the WebUI in your browser (eg http://localhost/transmission/).

Web UI

• OS X users will be prompted for a password when they first open Clutch (Linux users will need to use a .htaccess file to control access). The default user/pass is admin/password. This can be changed in Clutch.app's preferences.
• The web application works in much the same way as the desktop client, with a few limitations. It is designed to be as similar as possible to the desktop experience, so things like arrow key scrolling, Apple-select for selecting multiple torrents etc are provided :
  
  
  
• Preferences, transfer rate control and torrent sorting can be accessed via the menu button on the bottom left of the screen :
  
  
  
• The remote download folder, port etc can be set in the preferences :
  
  
  
• Each torrent also has it's own individual menu to pause/resume/delete individual torrents or groups of torrents (Opera doesn't support this) :