
 HOMR v0.1
-----------

I have for years recorded and collected Simpson episodes. I felt that I needed something
to simplify the management of my Simpson collection.
HOMR is a Freevo plugin that fills my needs.

 Features:
-----------
 * Downloads information about the seasons you have from wikipedia when an 
   episode is detected in a season that no information is stored.
 * Shows DVD cover of the seasons released.
 * Shows screenshot from nearly every episode.
 * Shows short informations about every episode
 * Play random functionallity
 * Shows which episodes that you are missing of each season.
 * Stores when you last saw the episode.
 
 
 Installation:
---------------
 Run "python setup.py install" for copying the needed files to the correct freevo catalogs.
 
 Edit your .freevo/local_conf.py file and add:
 --
plugin.activate('HOMR', args=("The Simpsons", "/TV/shows/Simpsons", "season%.2d") )
 --
 Among the other "plugin" lines. The second argument, "/TV/shows/Simpsons" are the
 main catalog where your Simpson episodes are stored.
 "season%.2d" are each season catalog. IE this will be "season01", "season10" and so on.
 (for "season1" use "season%d" only.
  
 You have to make sure that each episode's file name must start with the production code, for example:
 "BABF22 - HOMR.avi" for episode 9 season 12. What comes after "BABF22" does not matter.
 On my harddrives it looks like this:
 --
 /TV/shows/Simpsons/season12/BABF22 - HOMR.avi
 --
 
 
 Clear?
 
 HOMR Files:
-------------
 The normal location for HOMR related files are: (Might differ from linux dist to dist)
 
 /usr/lib/python2.4/site-packages/freevo/plugins/HOMR.py  
 - The plugins core.
 /usr/share/freevo/images/HOMR/The Simpsons.png 
 - The Simpsons family image. Taken from Wikipedia.
 /usr/share/freevo/images/HOMR/on.png 
 /usr/share/freevo/images/HOMR/off.png 
 - Images for showing if the episode was found or not.
 /var/cache/freevo/The Simpsons.HOMR
 - The episode data storage (~300 kb for all seasons.)
 /var/cache/freevo/The Simpsons/*
 - Images of each episode and season. Downloads when a new season is found from wikipedia.
   (Will be something like 6-8 mb for all seasons.)
  
 
 Future:
---------
 No future features are planned, but adding support for other TV shows wouldn't be hard.
 Feel free to send me patches.
 
 
 Help?
-------
 You're welcome to send praises, complains, requests for help to me Jonas Aaberg, cja@gmx.net
 (All kinds of orchids are very welcome too ;-) Please make sure to include "Freevo" and "HOMR" 
 in the subject line because cja@gmx.net is heavily spammed.
 
 
 
 
