Switch branches/tags
Find file
Fetching contributors…
Cannot retrieve contributors at this time
53 lines (41 sloc) 1.62 KB

MyShows API

Object-oriented wrapper over API of


gem install myshows


Simply require

require 'rubygems'
require 'myshows'

And use

# authorization is needed for some features
# requires valid login and md5(password)
profile = 'demo', 'fe01ce2a7fbac8fafaed7c982a04e229'
profile.shows   # => all user shows

# you can find show by title among user shows (smart search) 'big bang theory' # => show "The Big Bang Theory" 'TBBT'            # => show "The Big Bang Theory"

search =
tbbt ="The Big Bang Theory").first
tbbt.title      # => "The Big Bang Theory"
tbbt.ru_title   # => "Теория большого взрыва"
# and many other fields provided by API

tbbt.episodes   # => [...] - all episodes

# you can find episode by title (smart search)
pilot = tbbt.episode "the pilot episode"
# or by season and episode number
pilot = tbbt.episode 1, 1
pilot.title     # => "Pilot"      # => tbbt
pilot.air_date  # => "24.09.2007" (fields parsing would be done later)
# and many other fields provided by API

# if you are authorized:
pilot.uncheck!  # => this episode would be marked as 'unwatched'
pilot.check!    # => this episode would be marked as 'watched'

Look at for detailed documentation


rake spec


  • support all API (other user profiles, all unwatched episodes, …)

  • show and episode fields conversion to Ruby types


Vladimir Parfinenko, write at vladimir[dot]parfinenko[at]gmailcom