kettu

Port of http://github.com/kjg/derailleur and the original Transmission Web Client
using jquery, sammy and mustache.js.

By Frank Prößdorf [email protected].

kettu osaa monta asiaa.

Thanks

• Kriesse for the elegant design.
• kjg for all the work on the transmission web client and help.
• lenalena for introducing proper jspec testing to this project.
• currency.io for their easy way of adding the app to the homescreen.

Usage

You can use kettu instead of the original web client to remotely administrate your transmission application.

Using Environment Variables

If you're just trying kettu out, it is recommended to set the TRANSMISSION_WEB_HOME environment variable to the root path of this web client. Then you just need to open the location to the transmission web server (e.g. localhost:9091) and it will work.

Installation

Move the kettu files in the right location, and the next time you start Transmission, it will use kettu. If you're using the daemon, you can simply send it a SIGHUB.

Linux

Without overwriting the default Web Interface, you can drop the kettu files into: ~/.local/share/transmission/web/.

On Mac OS X, using a (pre-v2.0) nightly

In the current (pre-v2.0) nightlies on the mac, you can simply drop kettu in the Transmission Application Support folder and rename it web (~/Library/Application Support/Transmission/web/).

Configuring

Kettu has own settings.

Location categories

Kettu supports changing of location path. To make it simple, you can configure location categories. Put categories configuration into locationCategories.js file. See locationCategories.js.example for data format.

Goals

• Usage should be as simple as possible
• Try out new features that older browsers may not support
• Keep the code clean
• Write tests for everything

Tests

Unit Tests

There are jspecs in /spec which you can run by opening the index.html file within the spec directory.

Acceptance Tests

You need to install the chromedriver. Then there are capybara tests in features. You will just need to type cucumber features/<feature>.

Todo

• maybe have a trash icon where torrents can be dragged and dropped into
• maybe checkboxes in preferences could be on/off sliders, something with sliders
• maybe add to audio files, transforms