tvnamer 1.0

This is an old post I wrote, which was originally posted on neverfear.org on Thurs, 28th May 2009 7:54:39. Archived here for posterity.

There are 2 comments on this post.

As the "final commit" (archive.org link) 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 (archive.org link)

To install, simply do..

easy_install tvnamer

(You might need to prefix that with sudo depending on your system)

The Readme (archive.org link) 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 (archive.org link) 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) (archive.org link) , Anime filenames (archive.org link) , and much better Unicode support (archive.org link) .

To suggest other features, go to tvdb_api's issue tracker (archive.org link) 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 (archive.org link)