VIDEO BUDDHA - Readme
---------------------------------------------------------------------
	Version: 1.0.4
	Author:  Stieffers
	Email:   Stieffers@gmail.com
---------------------------------------------------------------------
	Cross platform, highly customizable video renamer
---------------------------------------------------------------------


ABOUT
---------------------------------------------------------------------
---------------------------------------------------------------------
Video Buddha is a crossplatform application developed using Python 
which allows for easy mass renaming of video files. Users are able 
to enter a set of definition matches so that files are renamed based 
on user-generated patterns. With a wide range of customizable options, 
Video Buddha gives you full control of how your files are renamed. 
This application started as a Python console script but has evolved 
into something much more powerful. Originally developed to make 
scraping with XBMC easier, Video Buddha is now powerful enough to 
take on much more sophisticated renaming tasks.


Say you have a number of video files all named in a similar 
fashion -- "_top.gear.12x01.hdtv.720_." Not the prettiest of 
filenames. So you enter a new definition into the definitions database 
where "_top.gear._" is replaced with "_Top Gear (UK)_." Now all instances 
of the show are changed accordingly. But wait, theres more! You can also
specify how you want the season and episode information to appear. The
old filename now becomes "_Top Gear (UK) - s12e01_", and if you want 
to keep the trailing information you can even end up with 
"_Top Gear (UK) - s12e01 - HDTV.720_." Buddha gives you all the options 
you need to clean up your video files.


* Renaming based on variable declaration
  * A file can be renamed by its respective sections
  * %t -> Title
  * %se -> Season and episode
  * %i -> Ending information
  * Ex: "_%t - %se - %i_" becomes "_Top Gear - s14e01 - HDTV.avi_"
* Season episode reformatting (examples based on season 1, episode 1)
  * S01E01
  * s01e01
  * 01x01
  * 101
* Which video formats to search for
* Whether to include the trailing information such as 'HDTV'
* Whether to create a log file per session which shows which files were 
  renamed, and what they were renamed to


USAGE
---------------------------------------------------------------------
---------------------------------------------------------------------
Windows:
	If you downloaded the win32 / 64 build then run video_buddha.exe
	If you downloaded the src, then ensuring you have Python 2.7 installed,
		execute video_buddha.py using the python interpretor.
		
Linux / Mac:
	Open the src folder and, ensuring you have Python 2.7 installed,
		execute video_buddha.py using the python interpretor.

        Dependencies:
            wxPython


VERSION HISTORY
---------------------------------------------------------------------
---------------------------------------------------------------------
v1.0.4
	- Added support for writing NFO files using information from
	  TheTVDB.com. Support is still semi-experimental, but should
	  work for files whith explicit shownames in their filename
	- Pretty sure I fixed some stuff too.
	- Bug in regex matching for titles is fixed.

v1.0.3
	- Added the console command line tool
	- If the first character of the trailing information is '.', '_', 
	  or '-', it will be removed. Re-add it using the variable renaming
	  in the options.
v1.0.2
	- Return statement was preventing loop through of all the database
	  patterns
v1.0.0
	Initial release
