Skip to content


Subversion checkout URL

You can clone with
Download ZIP
branch: master
Fetching contributors…

Cannot retrieve contributors at this time

38 lines (23 sloc) 1.609 kb
Ruby TV Show Xml Scraper
This is a public domain script I wrote for scraping TV episode information from The TV DB.
Do with it what you will, pretend you wrote it I don’t care.
The TV DB scraper will query the The TV DB web services and try to find the best metadata for your television shows. If it finds any information it will create a hidden folder called metadata beneath the video files and place an XML file and optionally an image which describes the show
1. Download a copy of Ruby and install on your machine
2. Run “ruby tvdb_scraper.rb PATH” where PATH represents the path containing tv shows
Keys to getting this to work
1. Ensure your directory structure follows the pattern \showname\seasonx
So Extras\Season 1\01.avi is a good starting point
2. Ensure the TV show name matches the exact same tv show name in TheTVDB
So it’s 24 not “Twenty Four”
3. Ensure you have a Season directory
Eg. place the first seasons episodes in the “Season 1” folder
4. The script runs recursively, so start small, with a folder containing only a few files.
What file names does it recognize?
1. 201 – blablbl.avi means Season 2 Episode
2. s02e01 – another episode.avi means season 2 episode 1
How do I rename my files to something a bit nicer than 2.avi
The script has a special option called —fixnames, when specified it will rename your files to a nicer format –
Careful with this option, it renames your files! Ensure all the metadata is 100% correct before using this.
What about specials?
Not supported yet in the script, contributions are welcome.
Jump to Line
Something went wrong with that request. Please try again.