derobo / tvdb_party

Simple Ruby library to talk to thetvdb.com

TvdbParty!

What?

TvdbParty is a simple Ruby library to talk to thetvdb.com database.

Install

sudo gem install tvdb_party

TvdbParty is hosted on Gemcutter

gem install tvdb_party

How?

set up the client
tvdb = TvdbParty::Search.new("YOURAPIKEY")

search for your series
results = tvdb.search('the west wing')

get the series
west_wing = tvdb.get_series_by_id(results["seriesid"])
puts west_wing.name
=> The West Wing

get an episode
episode_22 = west_wing.get_episode(1, 22)
puts episode_22.name
=> What Kind of Day Has It Been?

get series fanart – pass in your language
puts west_wing.fanart('en').first.url
=> http://thetvdb.com/banners/fanart/original/72521-2.jpg

get series posters
puts west_wing.posters('en').first.url
=> http://thetvdb.com/banners/posters/72521-1.jpg

get series banners
puts west_wing.series_banners('en').first.url
=> http://thetvdb.com/banners/graphical/189-g.jpg

get season posters
puts west_wing.season_posters(2, 'en').first.url
=> http://thetvdb.com/banners/seasons/72521-2.jpg

Thanks

Thanks to thetvdb.com for their awesome database allowing us to meta out to our hearts consent.

Project name graciously stolen from jduff/tmdb_party.