Home

What is it?

tvdb_api currently contains two parts, tvdb_api.py and tvnamer.py

tvdb_api

This is an easy to use Python interface to the TVDB API ( http://www.thetvdb.com ).

from tvdb_api import Tvdb
t = Tvdb()
print t['Scrubs'][4][22]['name' # This will print the name of Scrubs episode 22, in season 4
print t['My Name Is Earl'][2][1]['episodename'] # Prints name of episode 1 of season 2
print t['Scrubs'].search('my first', key='episodename')[0]['name'] # Prints the first episode whose name contains "my first"

For more information, see the tvdb_api page

tvnamer

TVNamer is a command-line tool to automatically names TV episode filenames, to more consistent and nicer-to-read names than “show.name.s2e02.abc.avi”. It was the reason tvdb_api.py was written

For more information, see the TVNamer page

API utilizers

• ccjensen – mp4tvtags – Automatically tags MP4 video files using tvdb_api and AtomicParsley
• davels – “tvdb-bulk-update”http://www.bitbucket.org/davels/tvdb-bulk-update/ – A MythTV tool to fill in TV metadata
• Doug Vaughan – Jamu – “performs a variety of utility functions on mythvideo metadata and its associated video files and directories.”. Doug also helped with tvdb_api’s development by reporting a bunch of bugs and suggesting features