Home

Welcome to the tvinfo wiki!

tvinfo

tools for performing TV information lookup

© 2008 Scott Raynel <[email protected]>

© 2007-2008 Perry Lorier

Installation

You can either run tvrenamer3 directly from your clone, or you can
install tvrenamer3 and the tvinfo package using the included
Python distutils setup script. Install to your system using:

$ sudo python setup.py install

Or install to your home directory using:

$ python setup.py install —prefix $HOME

and make sure that you’ve set your $PYTHONPATH correctly.

More Info

This package contains the tvinfo module and the tvrenamer3 script.

tvinfo

The tvinfo module provides an interface for performing lookups
of TV episode information from various webservices. A default
backend for thetvdb.com is provided along with a TV data model
that describes series, seasons and episodes.

The tvinfo module provides caching of episode information and
a way for different backends to be easily added.

tvrenamer

The tvrenamer3 script is provided as part of the standard package
to help organise your time-shifted TV files. tvrenamer3 will attempt
to determine the series name, season and episode number from a
filename using a fairly comprehensive set of common patterns. The
series will then be looked up using the tvinfo module and if the
series, season and episode is found, the file will be renamed
accordingly.

tvdump.py

tvdump.py is a script for testing the tvinfo backends. It is not installed
with the setup script as it is just for testing. Use it to do a lookup and
dump the results without actually renaming anything. tvdump.py will
use the tvinfo cache – force it to bypass it with —update. There are other
options as well – take a look. Example usage:

$ ./tvdump.py —update “midsomer murders”

Other stuff

TODO – TODO list