Metadata-Version: 1.0
Name: tvbutler
Version: 0.1a4
Summary: tvbutler reads RSS feeds from http://tvtorrents.com and downloads torrents of new episodes for you in your preferred quality
Home-page: https://github.com/tomster/tvbutler
Author: Tom Lazar
Author-email: tom@tomster.org
License: BSD
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).
        
        Installation and Usage
        ======================
        
        Just use `easy_install` like so::
        
          easy_install tvbutler
        
        Alternatively, download the archive, expand it and run::
        
          python setup.py install
        
        This will install a command line executable of the same name. It's 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`, the installer places a sample configuration and should be pretty self-explanatory::
        
          [main]
          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, which is configurable via the config file::
        
          global_exclude_regex=(all month|season[\s\d]*complete)
        
        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)
        
Keywords: rss bittorrent tv
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 2.5
Classifier: Programming Language :: Python :: 2.6
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Communications :: File Sharing
