tvnamer 1.0

ben
Wed, 27 May 2009 22:24:39 +0000

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