Read Me

Welcome to NZBivo!

NZBivo is a perl script that tracks when your favorite shows air,
and then searches for NZB files of those shows using various free sources on the internet.

## DISCLAIMER ##
This is free software (free as in beer and speech).  It comes with no warranty of any kind.
I take no responsibility for anything you may do with it or anything it may do to your system.
I have done fairly extentsive testing to ensure it is safe, but you take your fate into your own hands by running it.
It has been tested to work on OSX 10.5.6 but it *should* run on any system capable of running perl and
and installing the required modules, I just cannot personally vouch for them.
## DISCLAIMER ##

There have been *a lot* of changes since the .8 tree and they are too numerous to list here.
In all reality this is a completely new program, that just happens to do the same thing.

The following perl modules are *required*.  If you don't have even one of them installed
the program will fail to run and give you an error:

DBI;
DBD::SQLite
Data::Dumper;
XML::Simple;
XML::RSS;
Config::Auto;
POSIX;
LWP::Simple;
LWP::UserAgent;
LWP::UserAgent::WithCache;
HTTP::Cookies;
Compress::Zlib;
Cache::FileCache;
Date::Manip;
Log::Log4perl;

Usage is faily simple.  You should start by going over the nzbivo.conf and making sure everything is to your liking.
It should work out of the box, but depending on where you live in the world, your milage may vary.

You add shows to your db, you use the manageshows.pl script like so:

manageshows.pl -a "Some Show I Like"

Or delete with:

manageshows.pl -d "Some show I don't like"

If your show has more than one word in it, you *must* put it in quotes, otherwise it'll have problems.
This is a limitation of the way the shell parses arguments.

manageshows.pl searches tvrage, so you'll want to pass it a value that will return the correct show from there.
If you're not sure, you can visit http://www.tvrage.com/quickinfo.php?show=The%20Simpsons or whatever show you're looking for
to make sure you get the correct entry.  Generally it works pretty well, but sometimes you have to mess with the show name (a good example is "castle",
to get the one that is currently airing you have to put "castle 2009").

There are a few options, so run manageshows.pl -h for a quick description of them.  Additionally I have tried
to make useful comments in the code, so if you're still curious, I encourage you to poke around

Once the show had been added to the DB, it should be as simple as running nzbivo.pl.

We rely on tvrage.com for our season, episode, and title info (thanks tvrage!), and do nothing more 
than process that information.  So if seasons, episodes, titles, or whatever are showing up wrong
there is probably not much I can do to resolve that.

If you want it to grab an entire season or seasons of shows, you should be able to do this with some slight modifications.
Essentially you'll want to write something that grabs all the info from tvrage (or wherever) and inserts it into the DB.
Then the next time NZBivo runs it'll grab anything thats in the DB.  I leave this as an exercise for you, the user.
If someone does write something that does this well, let me know and I'll happily include it as an added tool, but I have
no intention of writing this myself :-D

That should be about it, happy NZBing!