This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

tvbutler reads RSS feeds from http://tvtorrents.com and downloads torrents of new episodes for you in your preferred quality (but is smart enough to fallback to non-HD versions, if available).

Usage

tvbutler is designed to work as a crontab or launchd entry: called without any parameters it will download all given feeds, try to identify shows and then figure out which episodes are available in which quality.

It then downloads the torrent files into the given target directory (which typically will be ‘watched’ by a torrent client).

tvbutler keeps a log of its activities in ~/.tvbutler/log and a (sqlite) database of known shows and episodes in ~/.tvbutler/database.db

Configuration

The configuration lives in ~/.tvbutler/config. If it doesn’t exist, tvbutler will create a sample configuration when it’s run for the first time. It has some comments and should thus be pretty self-explanatory:

[main]
torrent_download_dir=~/Downloads/
# one of sd, 720p, 1080p
preferred_quality=720p

# one per line, indented
feeds =
    http://www.tvtorrents.com/mytaggedRSS?digest=xxxxx
    http://www.tvtorrents.com/mydownloadRSS?digest=xxxx

Since tvbutler is aimed at downloading new episodes of currently running shows as they are released, it excludes by default all torrents it recognizes as archives of entire seasons. It does so by excluding all torrents whose description matches a regular expression. If you have a global_exclude_regex entry in the [main] section of your configuration it will be applied, if it’s missing, nothing will be filtered. The default looks like so:

global_exclude_regex=(all.month|month.of|season[\s\d]*complete)

Installation

Just install easy_install like so:

easy_install tvbutler

Alternatively, download the archive, expand it and run:

python setup.py install

This will install the command line executable tvbutler mentioned above.

TODO

  • archive or delete files older than n days (perhaps base decision on tag)
  • remove torrents from transmission that have reached their seeding limit

History

0.1.b1 - 2011-01-12

0.1a5 - 2010-12-17

  • robustness fix (tvbutler would barf on some entries and stop processing the remaining entries)
  • log to stdout, too to get instant feedback when calling tvbutler from console

0.1a4 - 2010-12-08

  • added global regular expression filter (defaults to skip archives of seasons)

    UPGRADE NOTE: add global_exclude_regex=(all.month|month.of|season[\s\d]*complete) to the [main] section your existing config to activate this feature.

0.1a3 - 2010-12-05

  • added logging

0.1a2 - 2010-12-05

Initial release (0.1a was nuked due to packaging foobar)

Release History

Release History

0.1b1

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1a5

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1a4

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1a3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1a2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1a

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
tvbutler-0.1b1.zip (15.4 kB) Copy SHA256 Checksum SHA256 Source Jan 12, 2011

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting