Difference between revisions of "Tmdb.py"

From MythTV Official Wiki
Jump to: navigation, search
m (add category)
 
m (mark as using the old syntax)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
{{stub}}
+
{{outdated2|Detailed information is for the old [[MythVideo_Grabber_Script_Format|MythVideo format]].  This script in 0.24 will use the new [[MythTV_Universal_Metadata_Format|universal format]].}}
 +
 
 +
== Output of ./tmdb.py --help ==
 +
 
 +
<code><pre>./tmdb.py --help
 +
Usage: tmdb.py usage: tmdb -hdruviomMPFBDS [parameters]
 +
<series name or 'series and season number' or 'series and season number and episode number'>
 +
 
 +
For details on using tmdb with Mythvideo see the tmdb wiki page at:
 +
http://www.mythtv.org/wiki/tmdb.py
 +
 
 +
Options:
 +
  -h, --help            show this help message and exit
 +
  -d, --debug          Show debugging info
 +
  -r, --raw            Dump raw data only
 +
  -u, --usage          Display examples for executing the tmdb script
 +
  -v, --version        Display version and author
 +
  -i, --interactive    Interaction mode (allows selection of a specific Movie
 +
                        or Person)
 +
  -l LANGUAGE, --language=LANGUAGE
 +
                        Select data that matches the specified language fall
 +
                        back to english if nothing found (e.g. 'es' Español,
 +
                        'de' Deutsch ... etc)
 +
  -M, --movielist      Get matching Movie list
 +
  -D, --moviedata      Get Movie metadata including graphic URLs
 +
  -H, --moviehash      Get Movie metadata including graphic URLs using a Hash
 +
                        value. See:
 +
                        http://api.themoviedb.org/2.1/methods/Hash.getInfo
 +
  -P, --peoplelist      Get matching People list
 +
  -I, --peopleinfo      Get A Person's metadata including graphic URLs
 +
</pre></code>
 +
 
 +
== Output of ./tmdb.py -u ==
 +
 
 +
=== Request tmdb.py verison number: ===
 +
<code><pre>> ./tmdb.py -v
 +
TheMovieDB APIv2 Query Query (v0.x.x) by R.D.Vaughan</pre></code>
 +
 
 +
=== Request a list of matching movie titles: ===
 +
<code><pre>> ./tmdb.py -M "Avatar"
 +
19995:Avatar (2009)
 +
8514:The Avatar State (2006)
 +
8518:Avatar Day (2006)
 +
13336:Chrysalis (2007)
 +
8493:The Avatar Returns (2005)
 +
8500:Avatar Roku (Winter Solstice (2)) (2005)
 +
8481:The Avatar and the Firelord (2007)
 +
12467:Avatar Aang (2008)</pre></code>
 +
 
 +
=== Request movie details using a TMDB#: ===
 +
<code><pre>> ./tmdb.py -D 19995
 +
Title:Avatar
 +
Year:2009
 +
ReleaseDate:2009-12-18
 +
InetRef:19995
 +
URL:http://www.themoviedb.org/movie/19995
 +
Director:James Cameron
 +
Plot:A band of humans are pitted in a battle against a distant planet's indigenous population.
 +
Runtime:166
 +
Coverart:http://images.themoviedb.org/posters/76198/avatar_xlg.jpg
 +
Fanart:http://images.themoviedb.org/backdrops/72434/wallpaper_05_1280x1024.jpg,http://images.themoviedb.org/backdrops/69971/avatar-newstills-101-full-01.jpg,http://images.themoviedb.org/backdrops/69968/avatar-3.jpg,http://images.themoviedb.org/backdrops/69965/avatar-2.jpg,http://images.themoviedb.org/backdrops/68648/Avatar.jpg,http://images.themoviedb.org/backdrops/67496/avatar2_resize.jpg,http://images.themoviedb.org/backdrops/67487/avatar1_resized.jpg,http://images.themoviedb.org/backdrops/52193/avatar_movie_based_ubisoft_game_concept_art_1.jpg
 +
Cast:Sam Worthington, Zoe Saldana, Stephen Lang, Sigourney Weaver, Michelle Rodríguez
 +
Genres:Science Fiction
 +
Studios:Lightstorm Entertainment
 +
Type:movie
 +
Imdb:0499549
 +
AlternativeName:Avatar
 +
Homepage:http://www.avatarmovie.com/
 +
Trailer:http://www.youtube.com/watch?v=j6AAt-oV3wE</pre></code>
 +
 
 +
=== Request movie details using a IMDB#: ===
 +
<code><pre>> ./tmdb.py -D 0499549
 +
Title:Avatar
 +
Year:2009
 +
ReleaseDate:2009-12-18
 +
InetRef:19995
 +
URL:http://www.themoviedb.org/movie/19995
 +
Director:James Cameron
 +
Plot:A band of humans are pitted in a battle against a distant planet's indigenous population.
 +
Runtime:166
 +
Coverart:http://images.themoviedb.org/posters/76198/avatar_xlg.jpg
 +
Fanart:http://images.themoviedb.org/backdrops/72434/wallpaper_05_1280x1024.jpg,http://images.themoviedb.org/backdrops/69971/avatar-newstills-101-full-01.jpg,http://images.themoviedb.org/backdrops/69968/avatar-3.jpg,http://images.themoviedb.org/backdrops/69965/avatar-2.jpg,http://images.themoviedb.org/backdrops/68648/Avatar.jpg,http://images.themoviedb.org/backdrops/67496/avatar2_resize.jpg,http://images.themoviedb.org/backdrops/67487/avatar1_resized.jpg,http://images.themoviedb.org/backdrops/52193/avatar_movie_based_ubisoft_game_concept_art_1.jpg
 +
Cast:Sam Worthington, Zoe Saldana, Stephen Lang, Sigourney Weaver, Michelle Rodríguez
 +
Genres:Science Fiction
 +
Studios:Lightstorm Entertainment
 +
Type:movie
 +
Imdb:0499549
 +
AlternativeName:Avatar
 +
Homepage:http://www.avatarmovie.com/
 +
Trailer:http://www.youtube.com/watch?v=j6AAt-oV3wE</pre></code>
 +
 
 +
=== Request a list of People matching a name: ===
 +
<code><pre>> ./tmdb.py -P "Cruise"
 +
500:Tom Cruise
 +
77716:Cruise Moylan</pre></code>
 +
 
 +
=== Request a Person's information using their TMDB id number: ===
 +
<code><pre>> ./tmdb.py -I 2638
 +
Name:Cary Grant
 +
AlsoKnownAs:Alexander Archibald Leach|Archibald Alec Leach
 +
Birthday:1904-01-18
 +
Birthplace:Bristol, England
 +
Filmography:North by Northwest|Character:Roger O. Thornhill|Id:213|Job:Actor|URL:http://www.themoviedb.org/movie/213
 +
Filmography:Arsenic and Old Lace|Character:Mortimer Brewster|Id:212|Job:Actor|URL:http://www.themoviedb.org/movie/212
 +
...
 +
Filmography:The Grass Is Greener|Character:Victor Rhyall, Earl|Id:25767|Job:Actor|URL:http://www.themoviedb.org/movie/25767
 +
Id:2638
 +
Profile:http://images.themoviedb.org/profiles/11078/CG_profile.jpg,http://images.themoviedb.org/profiles/11075/CG_profile.jpg,http://images.themoviedb.org/profiles/10994/CG_profile.jpg,http://images.themoviedb.org/profiles/10991/CG_profile.jpg,http://images.themoviedb.org/profiles/10988/CG_profile.jpg,http://images.themoviedb.org/profiles/10985/CG_profile.jpg,http://images.themoviedb.org/profiles/4414/Cary_Grant_profile.jpg
 +
Original:http://images.themoviedb.org/profiles/11078/CG.jpg,http://images.themoviedb.org/profiles/11075/CG.jpg,http://images.themoviedb.org/profiles/10994/CG.jpg,http://images.themoviedb.org/profiles/10991/CG.jpg,http://images.themoviedb.org/profiles/10988/CG.jpg,http://images.themoviedb.org/profiles/10985/CG.jpg,http://images.themoviedb.org/profiles/4414/Cary_Grant.jpg
 +
Thumb:http://images.themoviedb.org/profiles/11078/CG_thumb.jpg,http://images.themoviedb.org/profiles/11075/CG_thumb.jpg,http://images.themoviedb.org/profiles/10994/CG_thumb.jpg,http://images.themoviedb.org/profiles/10991/CG_thumb.jpg,http://images.themoviedb.org/profiles/10988/CG_thumb.jpg,http://images.themoviedb.org/profiles/10985/CG_thumb.jpg,http://images.themoviedb.org/profiles/4414/Cary_Grant_thumb.jpg
 +
KnownMovies:25
 +
Popularity:2
 +
URL:http://www.themoviedb.org/person/2638</pre></code>
 +
 
 +
=== Request Movie details using a Hash value: ===
 +
<code><pre>> ./tmdb.py -H "00277ff46533b155"
 +
Title:Willow
 +
Year:1988
 +
ReleaseDate:1988-05-20
 +
InetRef:847
 +
URL:http://www.themoviedb.org/movie/847
 +
Director:Ron Howard
 +
Plot:The dwarfish Nelwyn Willow Ufgood begins on an adventurous journey to protect the foundling Elora Danan who after a prophesy from the evil tyrant king Bavmorda must prepare for her end. Fantasy film from 1988 written by George Lucas.
 +
UserRating:7.0
 +
Runtime:126
 +
Coverart:http://images.themoviedb.org/posters/73366/folder.jpg,http://images.themoviedb.org/posters/20426/Willow.jpg
 +
Fanart:http://images.themoviedb.org/backdrops/19772/WILLOW-fanart.jpg,http://images.themoviedb.org/backdrops/11663/Willow_1920x1080.jpg
 +
Cast:Val Kilmer, Joanne Whalley, Warwick Davis, Jean Marsh, Patricia Hayes, Billy Barty, Pat Roach, Gavan O'Herlihy, David Steinberg, Phil Fondacaro
 +
Genres:Adventure,Fantasy
 +
Countries:United Kingdom, United States of America, New Zealand
 +
ScreenPlay:Bob Dolman
 +
Studios:Imagine Entertainment,Sony,Sony Pictures,Metro-Goldwyn-Mayer,Lucasfilm Ltd.
 +
Producer:Nigel Wooll
 +
ProductionDesign:Allan Cameron
 +
DirectorOfPhotography:Adrian Biddle
 +
OriginalMusicComposer:James Horner
 +
Story:George Lucas
 +
CostumeDesign:Barbara Lane
 +
Editor:Daniel P. Hanley, Mike Hill, Richard Hiscott
 +
Type:movie
 +
Casting:Janet Hirshenson, Jane Jenkins
 +
AssociateProducer:Joe Johnston
 +
Popularity:3
 +
Budget:35000000
 +
Imdb:0096446
 +
ArtDirection:Tim Hutchinson, Jim Pohl, Tony Reading, Kim Sinclair, Malcolm Stone</pre></code>
 +
 
 +
 
  
 
[[Category:MythVideo_Grabber_Scripts]]
 
[[Category:MythVideo_Grabber_Scripts]]

Latest revision as of 18:45, 16 July 2010

Time.png Outdated: Detailed information is for the old MythVideo format. This script in 0.24 will use the new universal format.

Output of ./tmdb.py --help

./tmdb.py --help
Usage: tmdb.py usage: tmdb -hdruviomMPFBDS [parameters]
 <series name or 'series and season number' or 'series and season number and episode number'>

For details on using tmdb with Mythvideo see the tmdb wiki page at:
http://www.mythtv.org/wiki/tmdb.py

Options:
  -h, --help            show this help message and exit
  -d, --debug           Show debugging info
  -r, --raw             Dump raw data only
  -u, --usage           Display examples for executing the tmdb script
  -v, --version         Display version and author
  -i, --interactive     Interaction mode (allows selection of a specific Movie
                        or Person)
  -l LANGUAGE, --language=LANGUAGE
                        Select data that matches the specified language fall
                        back to english if nothing found (e.g. 'es' Español,
                        'de' Deutsch ... etc)
  -M, --movielist       Get matching Movie list
  -D, --moviedata       Get Movie metadata including graphic URLs
  -H, --moviehash       Get Movie metadata including graphic URLs using a Hash
                        value. See:
                        http://api.themoviedb.org/2.1/methods/Hash.getInfo
  -P, --peoplelist      Get matching People list
  -I, --peopleinfo      Get A Person's metadata including graphic URLs

Output of ./tmdb.py -u

Request tmdb.py verison number:

> ./tmdb.py -v
TheMovieDB APIv2 Query Query (v0.x.x) by R.D.Vaughan

Request a list of matching movie titles:

> ./tmdb.py -M "Avatar"
19995:Avatar (2009)
8514:The Avatar State (2006)
8518:Avatar Day (2006)
13336:Chrysalis (2007)
8493:The Avatar Returns (2005)
8500:Avatar Roku (Winter Solstice (2)) (2005)
8481:The Avatar and the Firelord (2007)
12467:Avatar Aang (2008)

Request movie details using a TMDB#:

> ./tmdb.py -D 19995
Title:Avatar
Year:2009
ReleaseDate:2009-12-18
InetRef:19995
URL:http://www.themoviedb.org/movie/19995
Director:James Cameron
Plot:A band of humans are pitted in a battle against a distant planet's indigenous population.
Runtime:166
Coverart:http://images.themoviedb.org/posters/76198/avatar_xlg.jpg
Fanart:http://images.themoviedb.org/backdrops/72434/wallpaper_05_1280x1024.jpg,http://images.themoviedb.org/backdrops/69971/avatar-newstills-101-full-01.jpg,http://images.themoviedb.org/backdrops/69968/avatar-3.jpg,http://images.themoviedb.org/backdrops/69965/avatar-2.jpg,http://images.themoviedb.org/backdrops/68648/Avatar.jpg,http://images.themoviedb.org/backdrops/67496/avatar2_resize.jpg,http://images.themoviedb.org/backdrops/67487/avatar1_resized.jpg,http://images.themoviedb.org/backdrops/52193/avatar_movie_based_ubisoft_game_concept_art_1.jpg
Cast:Sam Worthington, Zoe Saldana, Stephen Lang, Sigourney Weaver, Michelle Rodríguez
Genres:Science Fiction
Studios:Lightstorm Entertainment
Type:movie
Imdb:0499549
AlternativeName:Avatar
Homepage:http://www.avatarmovie.com/
Trailer:http://www.youtube.com/watch?v=j6AAt-oV3wE

Request movie details using a IMDB#:

> ./tmdb.py -D 0499549
Title:Avatar
Year:2009
ReleaseDate:2009-12-18
InetRef:19995
URL:http://www.themoviedb.org/movie/19995
Director:James Cameron
Plot:A band of humans are pitted in a battle against a distant planet's indigenous population.
Runtime:166
Coverart:http://images.themoviedb.org/posters/76198/avatar_xlg.jpg
Fanart:http://images.themoviedb.org/backdrops/72434/wallpaper_05_1280x1024.jpg,http://images.themoviedb.org/backdrops/69971/avatar-newstills-101-full-01.jpg,http://images.themoviedb.org/backdrops/69968/avatar-3.jpg,http://images.themoviedb.org/backdrops/69965/avatar-2.jpg,http://images.themoviedb.org/backdrops/68648/Avatar.jpg,http://images.themoviedb.org/backdrops/67496/avatar2_resize.jpg,http://images.themoviedb.org/backdrops/67487/avatar1_resized.jpg,http://images.themoviedb.org/backdrops/52193/avatar_movie_based_ubisoft_game_concept_art_1.jpg
Cast:Sam Worthington, Zoe Saldana, Stephen Lang, Sigourney Weaver, Michelle Rodríguez
Genres:Science Fiction
Studios:Lightstorm Entertainment
Type:movie
Imdb:0499549
AlternativeName:Avatar
Homepage:http://www.avatarmovie.com/
Trailer:http://www.youtube.com/watch?v=j6AAt-oV3wE

Request a list of People matching a name:

> ./tmdb.py -P "Cruise"
500:Tom Cruise
77716:Cruise Moylan

Request a Person's information using their TMDB id number:

> ./tmdb.py -I 2638
Name:Cary Grant
AlsoKnownAs:Alexander Archibald Leach|Archibald Alec Leach
Birthday:1904-01-18
Birthplace:Bristol, England
Filmography:North by Northwest|Character:Roger O. Thornhill|Id:213|Job:Actor|URL:http://www.themoviedb.org/movie/213
Filmography:Arsenic and Old Lace|Character:Mortimer Brewster|Id:212|Job:Actor|URL:http://www.themoviedb.org/movie/212
...
Filmography:The Grass Is Greener|Character:Victor Rhyall, Earl|Id:25767|Job:Actor|URL:http://www.themoviedb.org/movie/25767
Id:2638
Profile:http://images.themoviedb.org/profiles/11078/CG_profile.jpg,http://images.themoviedb.org/profiles/11075/CG_profile.jpg,http://images.themoviedb.org/profiles/10994/CG_profile.jpg,http://images.themoviedb.org/profiles/10991/CG_profile.jpg,http://images.themoviedb.org/profiles/10988/CG_profile.jpg,http://images.themoviedb.org/profiles/10985/CG_profile.jpg,http://images.themoviedb.org/profiles/4414/Cary_Grant_profile.jpg
Original:http://images.themoviedb.org/profiles/11078/CG.jpg,http://images.themoviedb.org/profiles/11075/CG.jpg,http://images.themoviedb.org/profiles/10994/CG.jpg,http://images.themoviedb.org/profiles/10991/CG.jpg,http://images.themoviedb.org/profiles/10988/CG.jpg,http://images.themoviedb.org/profiles/10985/CG.jpg,http://images.themoviedb.org/profiles/4414/Cary_Grant.jpg
Thumb:http://images.themoviedb.org/profiles/11078/CG_thumb.jpg,http://images.themoviedb.org/profiles/11075/CG_thumb.jpg,http://images.themoviedb.org/profiles/10994/CG_thumb.jpg,http://images.themoviedb.org/profiles/10991/CG_thumb.jpg,http://images.themoviedb.org/profiles/10988/CG_thumb.jpg,http://images.themoviedb.org/profiles/10985/CG_thumb.jpg,http://images.themoviedb.org/profiles/4414/Cary_Grant_thumb.jpg
KnownMovies:25
Popularity:2
URL:http://www.themoviedb.org/person/2638

Request Movie details using a Hash value:

> ./tmdb.py -H "00277ff46533b155"
Title:Willow
Year:1988
ReleaseDate:1988-05-20
InetRef:847
URL:http://www.themoviedb.org/movie/847
Director:Ron Howard
Plot:The dwarfish Nelwyn Willow Ufgood begins on an adventurous journey to protect the foundling Elora Danan who after a prophesy from the evil tyrant king Bavmorda must prepare for her end. Fantasy film from 1988 written by George Lucas.
UserRating:7.0
Runtime:126
Coverart:http://images.themoviedb.org/posters/73366/folder.jpg,http://images.themoviedb.org/posters/20426/Willow.jpg
Fanart:http://images.themoviedb.org/backdrops/19772/WILLOW-fanart.jpg,http://images.themoviedb.org/backdrops/11663/Willow_1920x1080.jpg
Cast:Val Kilmer, Joanne Whalley, Warwick Davis, Jean Marsh, Patricia Hayes, Billy Barty, Pat Roach, Gavan O'Herlihy, David Steinberg, Phil Fondacaro
Genres:Adventure,Fantasy
Countries:United Kingdom, United States of America, New Zealand
ScreenPlay:Bob Dolman
Studios:Imagine Entertainment,Sony,Sony Pictures,Metro-Goldwyn-Mayer,Lucasfilm Ltd.
Producer:Nigel Wooll
ProductionDesign:Allan Cameron
DirectorOfPhotography:Adrian Biddle
OriginalMusicComposer:James Horner
Story:George Lucas
CostumeDesign:Barbara Lane
Editor:Daniel P. Hanley, Mike Hill, Richard Hiscott
Type:movie
Casting:Janet Hirshenson, Jane Jenkins
AssociateProducer:Joe Johnston
Popularity:3
Budget:35000000
Imdb:0096446
ArtDirection:Tim Hutchinson, Jim Pohl, Tony Reading, Kim Sinclair, Malcolm Stone