Frequently Asked Questions

Why don't my downloaded torrents appear in the Transmission.app desktop client?

Clutch has only recently been able to interact with the Transmission.app desktop client - it is recommended that you run Transmission >= 1.04 and Clutch >= 0.4. If you are running either version prior to these, you may have problems getting the two applications to interact.

Where can I download Clutch?

OS X and web-only bundles are available from clutchbt.com

What browsers does Clutch support?

Clutch has been tested on Safari, Firefox & Opera. Other browsers (konqueror etc) may or may not work. Internet Explorer is not supported.

What operating systems does Clutch support?

Clutch works on OS X 10.4+, and should work on any linux distribution that can run the Transmission daemon and a web server with PHP5+.

How do I install Clutch?

See the GettingStarted page.

Why doesn't Clutch list my torrents from Transmission.app?

You're more than likely running older versions of one or both applications. It's recommended that you run at least Transmission 1.04 and Clutch 0.4. If you're running a GTK GUI build of Transmission on linux, you are probably missing the ability to interact with Clutch - we hope to get the linux version working properly at some point but there may be intermittent problems in the meantime.

What ports do i need to forward?

There are 2 ports you need to forward :

• The web server port in the Clutch.app preferences :
  
  
• The bittorrent port in the web interface preferences :
  
  

In the example above you'd access the web interface on http://your.ip:9091/ , and bittorrent traffic would hit your machine on port 28456. You can set either of these ports to whatever you want.

The daemon does not appear to be running error on Linux

The web server can't read the path you've put in remote/data/socket.txt for some reason. Make sure the path you've put in remote/data/socket.txt actually exists, and is readable by the webserver.

• 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).
• 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/).

Could not connect to the server error on Linux

More than likely you have either a PHP error or a permissions error. The Details button should give you some clues. The most common reason for this error is that your PHP install is lacking either the JSON extension or the socket extension, or your permissions are incorect (see the previous question)

How can I password-protect Clutch on Linux?

You have to set up a .htaccess file in the Clutch web directory.

How can I schedule torrents in Clutch?

Clutch does not currently support scheduling, although it may in the future.

My linux GUI version of Transmission won't communicate with Clutch!

Clutch is currently only guaranteed to work with either the daemon on *nix systems, or the OS X Transmission.app client. The GTK GUI version of Transmission does not yet contain enough functionality to work 100% with Clutch, although you may get limited functionality.

Clutch on OS X has stopped working since i upgraded from the daemon-compatible version to the Transmission.app-compatible version

It has been reported that Clutch may have problems communicating with Transmission.app after an upgrade from version 0.1. If this is the case, using AppZapper to remove both Clutch.app and Transmission.app is reported to fix the problem.

How can I turn on debugging?

Assuming you have Clutch in the /Applications/ folder, open a terminal and cd into /Applications/Clutch.app/Contents/Resources/binary/web/remote. Edit the TransmissionController?.class.php file and change a couple of the lines near the top (around line 17)

public $Debug = false;
public $DebugToLogFile = false;

to

public $Debug = true;
public $DebugToLogFile = true;

It should dump some logging info into '/Applications/Clutch.app/Contents/Resources/binary/web/remote/data/debug.log

These paths will obviously differ on linux, but the basic process is the same.

How can I get the source code?

See the Development page. If you want to mess about with the PHP/JavaScript code, look in Applications/Clutch.app/Contents/Resources/binary/web/ on OS X (& if you are on linux, you probably already know where the PHP code is). Feel free to forward any patches or suggestions back to the developers.

How can I help?

See the Development page. If you're good at Cocoa, PHP, or AJAX/jScript and are interested in working on Clutch drop us a line. We're also desperate to get some decent documentation going, so if you are good at writing HOW-TOs please get in touch.

Its not working!

Hit the #transmission channel on irc.freenode.net and look for softwareelves or gimp :)