Difference between revisions of "MythVideo Grabber Script Format"
From MythTV Official Wiki
Iamlindoro (talk | contribs) |
Iamlindoro (talk | contribs) (→The Data Command) |
||
| Line 64: | Line 64: | ||
Year:2009 | Year:2009 | ||
Director:Stephen Williams | Director:Stephen Williams | ||
| − | Plot:The remaining island survivors start to feel the effects of the aftermath of moving the island, and Jack and Ben begin their quest to reunite the Oceanic 6 in order to return to the island with Locke's body in an attempt to save their former fellow castaways. | + | Plot:The remaining island survivors start to feel the effects of the |
| + | aftermath of moving the island, and Jack and Ben begin their quest | ||
| + | to reunite the Oceanic 6 in order to return to the island with Locke's | ||
| + | body in an attempt to save their former fellow castaways. | ||
UserRating:7.9 | UserRating:7.9 | ||
Screenshot:http://www.thetvdb.com/banners/episodes/73739/382841.jpg | Screenshot:http://www.thetvdb.com/banners/episodes/73739/382841.jpg | ||
InetRef:73739 | InetRef:73739 | ||
| − | Cast:Matthew Fox, Evangeline Lilly, Naveen Andrews, Elizabeth Mitchell, Michael Emerson, Terry O'Quinn, Daniel Dae Kim, Yunjin Kim, Josh Holloway, John Terry, Andrew Divoff, Sam Anderson, L. Scott Caldwell, Nestor Carbonell, Kevin Durand, Jeff Fahey, Tania Raymonde, Mira Furlan, Alan Dale, Sonya Walger, Rebecca Mader, Ken Leung, Jeremy Davies, Kiele Sanchez, Rodrigo Santoro | + | Cast:Matthew Fox, Evangeline Lilly, Naveen Andrews, Elizabeth Mitchell, |
| + | Michael Emerson, Terry O'Quinn, Daniel Dae Kim, Yunjin Kim, Josh Holloway, | ||
| + | John Terry, Andrew Divoff, Sam Anderson, L. Scott Caldwell, Nestor Carbonell, | ||
| + | Kevin Durand, Jeff Fahey, Tania Raymonde, Mira Furlan, Alan Dale, Sonya Walger, | ||
| + | Rebecca Mader, Ken Leung, Jeremy Davies, Kiele Sanchez, Rodrigo Santoro | ||
Genres:Action and Adventure, Drama, Science-Fiction | Genres:Action and Adventure, Drama, Science-Fiction | ||
Runtime:45 | Runtime:45 | ||
</pre> | </pre> | ||
|} | |} | ||
Revision as of 17:22, 28 October 2009
MythVideo grabber scripts are small executable perl, python, or binary applications which query online sources of metadata and return it in a format parseable by MythVideo. This page documents the current format required of the grabber scripts to function.
The Search Command
All scripts must provide a search command, which takes a title as an argument and return a list of possible results. The results must be one per line, in the format:
| Command Format | SCRIPTNAME -ARGS TITLE |
| Command Example | ./tmdb.pl -M "Harry" |
| Response Format | INETREF:TITLE |
| Response Example | 0241527:Harry Potter And The Philosopher's Stone (2001) 0304141:Harry Potter And The Prisoner Of Azkaban (2004) 0373889:Harry Potter and the Order of the Phoenix (2007) 0295297:Harry Potter And The Chamber Of Secrets (2002) 0330373:Harry Potter And The Goblet Of Fire (2005) 0216800:Harry, un ami qui vous veut du bien (2000) 0329028:Dumb and Dumberer: When Harry Met Lloyd (2003) 0118954:Deconstructing Harry (1997) 0066999:Dirty Harry (1971) 0098645:Who's Harry Crumb? (1989) 0098635:When Harry Met Sally... (1989) 0093148:Harry and the Hendersons (1987) 1201607:Harry Potter and the Deathly Hallows: Part II (2011) 0926084:Harry Potter and the Deathly Hallows: Part I (2010) 0417741:Harry Potter and the Half-Blood Prince (2009) 0048750:The Trouble with Harry (1955) |
Inetref is a number like an IMDB, TMDB, or TVDB number. It is a unique serial ID that identifies that film to the data source's API.
The Data Command
Each grabber must also provide a data command. The data returned includes items such as title, subtitle, year of release, and other textual metadata. Grabbers written for MythTV .23 or greater should also return image results for coverart, fanart, banners, and screenshots (where available). This command varies slightly depending on whether the script is for TV or Film material. For Television Material, the season and episode numbers are added to the arguments.
| Command Format (FILM) | SCRIPTNAME -ARGS INETREF |
| Command Example (FILM) | ./tmdb.pl -D 0241527 |
| Command Format (TELEVISION) | SCRIPTNAME -ARGS TITLE SEASONNUM EPISODENUM |
| Command Example (TELEVISION) | ./ttvdb.py -D 73739 5 1 |
| Response Format | KEY:DATA |
| Response Example | Title:Lost Subtitle:Because You Left Season:5 Episode:1 Year:2009 Director:Stephen Williams Plot:The remaining island survivors start to feel the effects of the aftermath of moving the island, and Jack and Ben begin their quest to reunite the Oceanic 6 in order to return to the island with Locke's body in an attempt to save their former fellow castaways. UserRating:7.9 Screenshot:http://www.thetvdb.com/banners/episodes/73739/382841.jpg InetRef:73739 Cast:Matthew Fox, Evangeline Lilly, Naveen Andrews, Elizabeth Mitchell, Michael Emerson, Terry O'Quinn, Daniel Dae Kim, Yunjin Kim, Josh Holloway, John Terry, Andrew Divoff, Sam Anderson, L. Scott Caldwell, Nestor Carbonell, Kevin Durand, Jeff Fahey, Tania Raymonde, Mira Furlan, Alan Dale, Sonya Walger, Rebecca Mader, Ken Leung, Jeremy Davies, Kiele Sanchez, Rodrigo Santoro Genres:Action and Adventure, Drama, Science-Fiction Runtime:45 |
