As the "final commit" mentions, 387 days and 330 commits after the I started, tvnamer and tvdb_api are at a point where I'm happy to release "version 1.0"!
tvnamer is probably of most interest, it's an automagical TV episode renamer, turning files from "some.show.s01e01.hdtv.blah.avi" to "Some Show - [01x01] - The Real Episode Name.avi", using information from thetvdb.com
To install, simply do..
easy_install tvnamer
(You might need to prefix that with sudo
depending on your system)
The Readme should explain all you need to know, but basically the usage is:
tvnamer [files to rename]
For example:
$ tvnamer scrubs.s01e01.avi #################### # Starting tvnamer # Processing 1 files # ..got tvdb mirrors # Starting to process files #################### # Processing scrubs (season: 1, episode 1) TVDB Search Results: 1 -> Scrubs # http://thetvdb.com/?tab=series&id=76156 Automatically selecting only result #################### Old name: scrubs.s01e01.avi New name: Scrubs - [01x01] - My First Day.avi Rename? ([y]/n/a/q)
Enter y
, hit return and tada - nicely named files.
It'll also work on multiple files or directories of files and has various options, but see the Readme for more information!
I'm now starting work on tvnamer 2.0 - the current code "works", but isn't very expandable (and is rather messy). The next version of tvnamer will include support for things like multiple episodes in one file (s01e23e24), Anime filenames, and much better Unicode support.
To suggest other features, go to tvdb_api's issue tracker and create tickets!
As somewhat of a side-note, I'm also working on an OS X GUI for tvnamer. I've never used really used ObjC/Cocoa before, so it might be a while until something useful emerges.. but you can follow it's development on github.com/dbr/tvnamergui_osx