ruTorrent - Plugins

ruTorrent's features can be extended in many different ways through the use of plugins. Though some more common ones will be installed when installing ruTorrent itself there are lots more that can be added.

Naturally, this guide assumes you know how to install ruTorrent (and have done so). Plugins are also added either via SSH or FTP and you may need to connect to your slot via SSH to configure some plugins. You will be instructed to connect via SSH where this is the case.

This page provides information on the most common custom plugins, how to install them and troubleshooting the most common problems that can arise. Please note though the plugins should work (if you follow the guide properly), Feral cannot provide much support for their use or help should anything go wrong. Please make sure you've read these FAQ pages fully as help on the problem may be covered already.

General method

Plugins can be added to ruTorrent simply by adding its directory to ruTorrent's plugins directory. This is possible in a number of ways, but the easiest is SSH. Since plugins are self-contained in their own directories, you can also just upload this to ruTorrent's plugin directory.

The method described below will pull the plugin from the ruTorrent plugin repository. If the plugin you want is listed under the 'Specific instructions' section please read those instructions first.

Run the following commands to install from the ruTorrent repository, replacing plugin_name with the actual name of the plugin you wish to install:

cd ~/www/$(whoami).$(hostname -f)/public_html/rutorrent/plugins/
svn checkout https://github.com/Novik/ruTorrent/trunk/plugins/plugin_name

Specific instructions

Sometimes a plugin needs a different approach. This can be either because the download is located in a different place, another version is needed, the plugin depends on other software or because there are further steps needed to get the plugin up and running.

Autodl irssi

A separate article covers installing autodl irssi.

Coloured Ratio Column

This plugin adds colour to your ruTorrent UI's ratio column, changing from red to green (though orange and yellow) as your ratio increases.

To install, execute the following:

wget -qO ~/ratio.zip http://git.io/71cumA
unzip -qo ~/ratio.zip -d ~/www/$(whoami).$(hostname -f)/public_html/rutorrent/plugins/
rm -f ratio.zip

Then simply open ruTorrent (or refresh the page if it was already open) to see the changes.

Filemanager

The Filemanager plugin adds a way of managing the files on your slot to ruTorrent.

Installation

To install Filemanager execute these commands:

cd ~/www/$(whoami).$(hostname -f)/public_html/rutorrent/plugins/
svn co -q https://github.com/nelu/rutorrent-thirdparty-plugins/trunk/filemanager

Using the screenshots function

First, you'll need to install FFmpeg to your slot. Next, configure Filemanager with:

cd && sed -i "s|(getExternal(\"ffprobe\")|(getExternal(\"~/bin/ffprobe\")|g" ~/www/$(whoami).$(hostname -f)/public_html/rutorrent/plugins/filemanager/flm.class.php
sed -i "s|(getExternal('ffmpeg')|(getExternal('$(pwd)/bin/ffmpeg')|g" ~/www/$(whoami).$(hostname -f)/public_html/rutorrent/plugins/filemanager/flm.class.php

Troubleshooting Filemanager

When I do something (create an archive, move a file etc.) the action seems to complete but nothing has changed

Make sure you've set the permissions correctly in Filemanager's scripts directory.

When I try to generate screenshots I get ffmpeg/ffprobe related errors

Make sure you've configured screenshots to point to the instance of ffmpeg running on your slot. If in doubt, follow this guide from top to bottom again and refresh ruTorrent.

Fileshare

This plugin allows you to create a URL out of your files for download via HTTP(S). It requires Filemanager to run (see the section above).

To install Fileshare execute these commands:

cd ~/www/$(whoami).$(hostname -f)/public_html/rutorrent/plugins/
svn co -q https://github.com/nelu/rutorrent-thirdparty-plugins/trunk/fileshare

These commands will configure the plugin to run on your slot:

ln -s ~/www/$(whoami).$(hostname -f)/public_html/rutorrent/plugins/fileshare/share.php ~/www/$(whoami).$(hostname -f)/public_html/
sed "/if(getConfFile(/d" -i ~/www/$(whoami).$(hostname -f)/public_html/rutorrent/plugins/fileshare/share.php
sed -i "s|'http://mydomain.com/share.php';|'http://$(whoami).$(hostname -f)/share.php';|g" ~/www/$(whoami).$(hostname -f)/public_html/rutorrent/plugins/fileshare/conf.php

Fileupload

This plugin will allow you to use Plowshare to upload to various filesharing services via ruTorrent.

As it's not possible to set a path to plowup (Plowshare's uploading software) within the plugin's configuration files you'll need to make sure that plowup is in your PATH. Otherwise you'll receive an error that rTorrent is not able to access it. To do this, please log in via SSH and execute the following commands:

echo "PATH=$HOME/bin:$PATH" > ~/.bashrc
source ~/.bashrc

Installation

To install Plowshare execute the following commands:

mkdir -p ~/bin && bash
git clone https://github.com/mcrapet/plowshare.git ~/.plowshare-source && cd ~/.plowshare-source
make install PREFIX=$HOME
cd && rm -rf .plowshare-source

Run this command to install the plowshare modules:

plowmod --install

If you get "command not found" then you need to revisit the preparation steps above because your ~/bin/ directory is not in PATH.

Execute these commands to install the plugin itself:

cd ~/www/$(whoami).$(hostname -f)/public_html/rutorrent/plugins/
svn co -q https://github.com/nelu/rutorrent-thirdparty-plugins/trunk/fileupload

You should then refresh ruTorrent to make sure the plugin can communicate with your plowup binary correctly.

Troubleshooting

If you get an error ("fileupload: Plugin will not work. rTorrent user can't access external program (plowup)."), make sure that you have taken the steps above to add ~/bin to PATH. Then, kill and restart rTorrent.

Mediastream

This is a plugin to allow you to stream from within ruTorrent. It requires the DivX web player to be installed first on your computer. This guide does not cover that step and for anything other than test streaming something like Plex will probably be a better solution for you.

Installation

Mediastream requires Filemanager (see the section above). Install Mediasteam using the following commands:

cd ~/www/$(whoami).$(hostname -f)/public_html/rutorrent/plugins/
svn co -q https://github.com/nelu/rutorrent-thirdparty-plugins/trunk/mediastream

Configuration

mkdir ~/www/$(whoami).$(hostname -f)/public_html/stream
ln -s ~/www/$(whoami).$(hostname -f)/public_html/rutorrent/plugins/mediastream/view.php ~/www/$(whoami).$(hostname -f)/public_html/stream/
sed -i "s|'http://mydomain.com/stream/view.php';|'http://$(whoami).$(hostname -f)/stream/view.php';|g" ~/www/$(whoami).$(hostname -f)/public_html/rutorrent/plugins/mediastream/conf.php

Troubleshooting

I get the error "Video cannot be found, it may have been removed"
Please make sure the configuration steps have been followed correctly.

Screenshots

The plugin uses ffmpeg to generate screenshots and due to the removal of this software from Debian stable you'll need to install FFmpeg to your slot. Next, install and configure the screenshots plugin itself with:

rm -rf ~/www/$(whoami).$(hostname -f)/public_html/rutorrent/plugins/screenshots
wget -q https://bintray.com/artifact/download/novik65/generic/plugins/screenshots-3.6.tar.gz
tar xf screenshots-3.6.tar.gz -C ~/www/$(whoami).$(hostname -f)/public_html/rutorrent/plugins/
rm screenshots-3.6.tar.gz
cd && sed -i "s|ffmpeg'] = ''|ffmpeg'] = '$(pwd)/bin/ffmpeg'|g" ~/www/$(whoami).$(hostname -f)/public_html/rutorrent/plugins/screenshots/conf.php

The first command removes any existing instance of screenshots in case you previously installed an incorrect version. Naturally if you are using the 3.7 version of ruTorrent then you can install Screenshots by following the general plugin install method at the top of this page.

Troubleshooting

When I load ruTorrent I get an error "screenshots: Plugin will not work. rTorrent user can't access external program (ffmpeg)"
Make sure you've configured screenshots to point to the instance of ffmpeg running on your slot.
When I generate screenshots I get no pictures, just a list of numbers
That happens when using the 3.7 version of screenshots with the 3.6 version of ruTorrent. Please install the 3.6 version using the instructions above.

RSS

Since ruTorrent uses the filesystem as a database, the use of its own RSS plugin is not recommended. Things like filling the disk can result in RSS feed information being lost. Instead, if you wish to use RSS feeds, please consider Flexget.

Unpack

This plugin allows you to extract from .zip and .rar archives, directly from ruTorrent.

To install it, execute the following:

rm -rf ~/www/$(whoami).$(hostname -f)/public_html/rutorrent/plugins/unpack
wget -q https://bintray.com/novik65/generic/download_file?file_path=plugins%2Funpack-3.6.tar.gz
tar xf download_file\?file_path\=plugins%2Funpack-3.6.tar.gz -C ~/www/$(whoami).$(hostname -f)/public_html/rutorrent/plugins/
rm download_file\?file_path\=plugins%2Funpack-3.6.tar.gz

The first command removes any existing instance of unpack in case you previously installed an incorrect version. Naturally if you are using the 3.7 version of ruTorrent then you can install unpack by following the general plugin install method at the top of this page.