A small ruby library for implementing with the TVRage API.
Switch branches/tags
Nothing to show
Pull request Compare This branch is even with paulingham:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



A simple and small Ruby Library for the TVRage API. (here)

What is a GoggleBox?

'Goggle Box' is 'Cockney' (a dialect of British English) rhyming slang for television. Thanks to Caius for the name, which was briefly discussed in the #nwrug IRC channel.

What does it do?

It allows you to search and retrieve Shows and Episodes from the TVRage API. Objects are returned as OpenStructs.



>> shows = GoggleBox::TVRage::Show.search("Better With You")
=> [#<OpenStruct status="New Series", started="2010", classification="Scripted", country="US", ended="0", genres=#<OpenStruct genre=["Comedy", "Family"]>, link="http://www.tvrage.com/Better_Together", name="Better With You", showid="25745", seasons="1">..]

Show Information

>> show = GoggleBox::TVRage::Show.new(shows.first.showid)
=> #<OpenStruct origin_country="US", runtime="30", startdate="Sep/22/2010", status="New Series", started="2010", timezone="GMT-5 -DST", showlink="http://tvrage.com/Better_Together", akas=#<OpenStruct aka=["Better Together", "Leapfrog", "That Couple"]>, classification="Scripted", airtime="20:30", showname="Better With You", ended=nil, network="ABC", genres=#<OpenStruct genre=["Comedy", "Family"]>, airday="Wednesday", showid="25745", seasons="1">

Lazy Loading (Includes Episode Listings)

>> show = GoggleBox::TVRage::Show.new(shows.first.showid, :lazy => true)

- If one season only
>> show.episode_list.seasons => Only season or array of seasons
>> show.episode_list.seasons.episodes => Episodes in this season

- If more than one season
>> show.episode_list.seasons.first => First season
>> show.episode_list.seasons.second => Second season etc
>> show.episode_list.seasons.first.episodes => Array of episodes in season etc

Episode Information

>> GoggleBox::TVRage::Episode.listings_by_show(show.showid)
=> #<OpenStruct season=#<OpenStruct episode=[#<OpenStruct prodnum="296777", seasonnum="01", epnum="1", link="http://www.tvrage.com/Better_With_You/episodes/1064933988", title="Pilot", airdate="2010-09-22">]..>
>> GoggleBox::TVRage::Episode.information(show.showid, '1x01')
=> #<OpenStruct number="01x01", url="http://www.tvrage.com/Better_Together/episodes/1064933988", title="Pilot", airdate="2010-09-22">
>> GoggleBox::TVRage::Episode.next_episode(show.showid)
=> #<OpenStruct number="01x11", airtime=["2011-01-05T20:30:00-5:00", "1294273800"], title="Better with Skinny Jeans", airdate="2011-01-05">
>> GoggleBox::TVRage::Episode.latest_episode(show.showid)
=> #<OpenStruct number="01x10", title="Better with Christmas Crap", airdate="2010-12-08">

What doesn't it do?

At the minute, it doesn't access the full functionality of the TVRage API. For example, it doesn't yet hook into the TVRage Scheduler or Countdown as these are intended for a future release.

Still todo

  1. Finish off less important TVRage functionality (countdowns etc)
  2. Implement mappings to override default schema of TVRage and other providers response (season to seasons etc)
  3. Plug in TheTVDB, IMDB etc
  4. Tests could be better - they'll improve over time and change


  • Caius - For the name
  • hsume2 - I based the original tests on those from sofa.