[Eldorado]

I thought I would get the ball rolling on getting the next piece in the proposed Video Falcon project - common meta data script

I've put the initial version on git - https://github.com/Eldorados/xbmc-metautils

This version was pulled from the master branch of Icefilms, I've basically put everything into it's own script folder and set it up to stand on it's own

Basic functionality:
* addon calls this module with a episode/movie imdb id or title
* module looks in its database for metadata for the required episode/movie
* if not found it scrapes a site for the required metadata, adds it to the database and returns it
* if it is found, it simply returns it from the database
* search by name and return a list of possible matches

How to

When searching by just movie/tv show name I recommend to try and pass in as clean a name as possible, strip anything that is not apart of the actual name eg. many sites display 'The Hangover (2009)', you need to strip (2009) from the name and pass the year in separately

Initialize:

Code:

metaget=metahandlers.MetaData()

You can specify a new cache path by specifying path='<addon data path>' but recommended to use the default

If you wish to download the covers to the cache folders, in prep to release a meta data zip pack to users, specify the preparezip=True option

Code:

metaget=metahandlers.MetaData(preparezip=True)

Search for movie:

Code:

Search by IMDB ID:
meta = metaget.get_meta('movie', movie_name, imdb_id=imdb_id)

Serach by TMDB ID:
meta = metaget.get_meta('movie', movie_name, tmdb_id=tmdb_id)

Search by movie name + year
meta = metaget.get_meta('movie', movie_name, year=year)

Search for tv series:

Code:

Search by IMDB ID:
meta = metaget.get_meta('tvshow',tvshow_name, imdb_id=imdb_id)

Search by name:
meta = metaget.get_meta('tvshow',tvshow_name)

Search for tv show season covers:

By this point you *should* have the imdb id of the tv show, if you don't have it then no results will be returned

get_seasons() returns a dictionary for each season found in order

Code:

season_list = [1,2,3]
seasons = metaget.get_seasons(imdb_id, season_list)

Search for tv show episode:

Code:

season_num = 1
episode_num = 1
episode=metaget.get_episode_meta(imdb_id, season_num, episode_num)

Update watched status:
Will update status in DB from 6 to 7 or reverse depending on what initial value is, 6 = unwatched, 7=watched

Code:

metaget.change_watched('movie', movie_name, imdb_id, year)
or
metaget.change_watched('tvshow', tvshow_name, imdb_id)
or
metaget.change_watched('episode', episode_name, imdb_id, season)

Search for a movie by name and return a list of possible matches:

Code:

search_meta = metaget.search_movies(movie_name)

Returns an array of dictionaries with the following data:
- IMDB ID
- TMDB ID
- Name
- Year

Meta Data being collected

Movies:

Code:

IMDB ID
TMDB ID
Title
Writer
Director
Tagline
Cast & Role
Rating
Duration
Plot
MPAA Rating
Premiered
Year
Genre
Studio
Trailer URL
Thumb URL
Cover URL
Backdrop/Fanart URL
Overlay (watched status)

TV Shows:

Code:

IMDB ID
TheTVDB ID
Title
Rating
Duration
Plot
MPAA Rating
Premiered
Genre
Studio
Cast & Role
Trailer URL
Thumb URL
Cover URL
Backdrop/Fanart URL
Overlay (watched status)

Seasons:

Code:

IMDB ID
TheTVDB ID
Season #
Cover URL
Overlay (watched status)

Episodes:

Code:

IMDB ID
TheTVDB ID
Episode ID
Season #
Episode #
Title
Director
Writer
Plot
Rating
Premiered
Poster URL
Overlay (watched status)

To Do's

- LOTS of code cleanup/optimization
- add more meta - director, writers, cast DONE
- fleshing out methods and how they are called
- fix unicode problems, possibly integrating with t0mm0.common DONE
- metacontainers needs attention
- create a metacontainer zip file to optionally download instead of creating a blank DB ala icefilms

All welcome who are wanting to help!