Very similar to tv_cat in semantics (see tv_cat),
except whenever a programme appears with date entry the
title and date are used to look up extra data by using the
<B>--output FILEB> write to FILE rather than standard output.
<B>--with-keywordsB> include IDMb keywords in the output file.
<B>--with-plotB> include IDMb plot summary in the output file.
<B>--actors NUMBERB> number of actors from IMDb to add (default=3).
<B>--quietB> disable all status messages (that normally appear on stderr).
<B>--downloadB> try to download data files if they are missing (in --prepStage).
<B>--statsB> output grab stats (stats output disabled in --quiet mode).
<B>--debugB> output info from movie matching
<B>--movies-onlyB> only augment programs that look like movie listings (4 digit
All programs are checked against imdb.com data (unless --movies-only is used).
For the purposes of tv_imdb, an exact match is defined as a case
insensitive match against imdb.com data (which may or may not include the
transformation of & to and and vice-versa.
If the program includes a 4 digit date field the following
matches are attempted, with the first successful match being used:
<B>1.B> an exact title/year match against movie titles is done
<B>2.B> an exact title match against tv series (and tv mini series)
<B>3.B> an exact title match against movie titles with production dates
within 2 years of the date value.
Unless --movies-only is used, if the program does not include a 4 digit
date field the following
matches are attempted, the first succeeding match is used:
<B>1.B> an exact title match against tv series (and tv mini series)
When a match is found in the imdb.com data the following is applied:
<B>1.B> the title field is set to match exactly the title from the
imdb.com data. This includes modification of the case to match and any
transformations mentioned above.
<B>2.B> if the match is a movie, the date field is set to imdb.com
4 digit year of production.
<B>3.B> the type of match found (Movie, TV Movie, Video Movie, TV Series,
or TV Mini Series) is placed in the categories field.
<B>4.B> the url to the www.imdb.com page is added
<B>5.B> the director is added if the match was a movie or if only one director
is listed in the imdb.com data (because some tv series have > 30 directors)
<B>6.B> the top 3 billing actors are added (use -actors [num] to adjust).
<B>7.B> genres added to categories field (current list of genres are
Short, Drama, Comedy, Documentary, Animation, Adult, Action, Family, Romance,
Crime, Thriller, Musical, Adventure, Western, Horror, Sci-Fi, Fantasy, Mystery,
War, Film-Noir, Music
<B>8.B> imdb user ratings added to star-ratings field.
<B>9.B> imdb keywords added to keyword fields (if --with-keywords used).
<B>10.B> imdb plot summary is added (if --with-plot used).
The --prepStage needs a lot of memory to run at a reasonable speed,
over 250 megabytes with the current imdb data files. For there to be
250 megabytes free for tv_imdb, the system will need at least 512 megabytes
of RAM. Running with less can take hours (or days!) - although fortunately
this stage needs to be run only once after downloading the data files.
Could use a --configure step just like the grabbers so you do not have
to specify the --imdbdir on the command line every time. Also this could
step you through the prep stages with more description of what is being
done and what is required. Configure could also control the number of
actors to add (since some movies have an awful lot), currently we are
adding the top 3.
How and what to look up needs to be option driven.
Needs some more controls for fine tuning close matches. For
instance, currently it looks like the North America grabber only has
date entries for movies, but the imdb.com data contains made for video
movies as well as as real movies, ot is its possible to get the
wrong data to be inserted. In this case we may want to say ignore tv
series and ignore tv mini series. Along with this, wed want
to define what a close match is. For instance does a movie by the
same title with a date out by 1 year or 2 years considered a match
(currently were using 2).
Nice to haves include: verification/addition of programe MPAA/VCHIP ratings,
addition of imdb.com user ratings (by votes) to programes. Potenially we
could expand to include country of origin, description, writer and
producer credits, maybe even commentator.
Heh, if the XMLTV.dtd supported it, we could even include urls to head
shots of the actors :)