Updatorr

deluge-updatorr is a Deluge plugin for automatic torrents updates.

If you're periodically checking your favourite torrent tracker site, on which torrents are organized as articles (forum-like trackers), to verify whether a specific torrents have been updated (e.g. torrent bundling some TV-series is updated with a new episode), then Updatorr is might be of use.

You activate Updatorr plugin, set autoupdate period and trackers sites credentials, choose torrents to be updated from Deluge torrents list, and Updatorr will do checks for you. When torrent update is available, Updatorr will replace old torrent with an updated one, and download new files from new torrent.

Automatic updates are available for:

- RuTracker.org (ex torrents.ru) - http://rutracker.org/

Deluge is a lightweight, Free Software, cross-platform BitTorrent client. Download it at http://deluge-torrent.org/

Installation

Open Deluge, go to "Preferences -> Plugins -> Install plugin" and choose Updatorr .egg file.

If you are to build .egg file from source code yourself use python setup.py bdist_egg command in source code root directory.

Trackers Handlers

The information below is intended for those wishing to enable Updatorr autoupdates for their favourite tracker site.

In order to perform automatic updates Updatorr should be instructed how to perform those, as different torrent tracking sites require different machinery to get updated torrents.

Tracker handlers are nothing more as relatively simple scripts in great Python programming language.

To create a tracker handler class one needs to:

0. Have essential knowledge in Python programming;
1. Get Updatorr source code from http://github.com/idlesign/deluge-updatorr/;
2. Create hander_{mytracker}.py file under updatorr/tracker_handlers/;
3. In that file subclass BaseTrackerHandler and implement its get_torrent_file() method; Note: See base class properties and methods, as they might be of use.
4. In that file register you class with register_tracker_handler().

Tracker handler sample updatorr/tracker_handlers/handler_mytrack.py:

from updatorr.handler_base import BaseTrackerHandler, register_tracker_handler

class MyTrackHandler(BaseTrackerHandler):

 # Let's suppose that tracker site doesn't require authorization.
 login_required = True

 def get_torrent_file(self):
 # Here one should implement .torrent file download and
 # save into filesystem. See BaseTrackerHandler fo helper methods.
 torrent_filepath = '/somewhere/in/my/filesystem/new.torrent'
 return torrent_filepath

register_tracker_handler('mytrackaurl.com', MyTrackHandler)
register_tracker_handler('yotr.su', MyTrackHandler

See updatorr/tracker_handlers/handler_rutracker.py and updatorr/handler_base.py for reference. Read docstrings of Updatorr.

Get involved into deluge-updatorr

Submit issues. If you spotted something weird in application behavior or want to propose a feature you can do that at https://github.com/idlesign/deluge-updatorr/issues.

Write code. If you are eager to participate in application development, fork it at https://github.com/idlesign/deluge-updatorr, write your code, whether it should be a bugfix or a feature implementation, and make a pull request right from the forked project page.

Spread the word. If you have some tips and tricks or any other words in mind that you think might be of interest for the others — publish it.

The tip

You might be interested in considering other Deluge plugins at http://dev.deluge-torrent.org/wiki/Plugins/.

Requirements:

• Python
• Deluge