# The Movie DB - Movies Importer

The Movie Database (TMDb) is a community built movie and TV database and is an excellant source for information on movies and TV shows.

Yate allows you to search TMDb in order to extract metadata and artwork for files which contain a video track.

Select one or more tracks which contain video and start the importer. Note that any selected tracks which do not contain video will be ignored. Further, any video tracks which can be identified as tv shows will be ignored. Note that searches and imports apply to a single file at a time.

Note that this importer assumes that any file which contains video is a movie. To search for metadata for TV shows use the The Movie DB - TV Importer.

You must first search the database by specifying the metadata to be used. The Title field is the only mandatory field. The field will be populated with the file's contained Title metadata, or if empty, the file's name. Hint: remove all extraneous information such as year from the title.

The remaining search fields either filter the searched metadata or can in some cases contain the language used to return textual information. The Year field restricts the search to a particular year. The field is initially populated with the contents of the file's Year metadata.

The language code is an optional field formatted as follows:

> ll
> or
> ll-cc

Where ll is an ISO 639-1 language code. cc is an ISO 3166-1 alpha-2 country code. Setting this field may produce text other than the default of English. You can use the disclosure buttons to add the codes based on partial list of languages and countries.

The optional region field can contain an ISO 3166-1 alpha-2 country code. The presense of the field may filter the results based on the specfied region. The disclosure button can be used to add the code based on a partial country list.

The last option Allow adult content, in theory is intended to filter out porn. Note that he effectiveness of this filter depends on the correct labelling of items in the database.

The Import Settings panel allows you to specify what you'd like to import. Note that the Results panel is only accessable when there are results to view.

When your search criteria and import preferences have been set, click on the Search button. When the search has completed a list of potential matches will be displayed on the Results panel. At this point you can still make changes to the import settings. The Overview button will display descriptive text for the selected match (as will double clicking). If you are happy with a match, click on the Import button. This will then download the required information which will be saved to the file.

After importing, if only one video file was available, the importer will terminate. If more than one video file was available, you can use the Next and Previous buttons to move to a different file.

The following import settings are available:

Adult content indicator
  A UDTI named tMDb Adult Content will be created with a value of true or false.
Artwork - Backdrop
  If available, the movie's backdrop image will be downloaded. Note that depending on your Artwork scaling preferences, the image may be scaled down.
Artwork Collection - Backdrop
  If the movie is part of a collection and a backdrop is available, the collection's backdrop image will be downloaded. Note that depending on your Artwork scaling preferences, the image may be scaled down.
Artwork Collection - Poster
  If the movie is part of a collection and a poster is available, the collection's poster image will be downloaded. Note that depending on your Artwork scaling preferences, the image may be scaled down.
Artwork - Poster
  If available, the movie's poster image will be downloaded. Note that depending on your Artwork scaling preferences, the image may be scaled down.
Artwork URLs
  The URLs of all available images will be saved as UDURLs
Budget
  The budget will be saved to a UDTI named tMDb Budget.
Cast
  All available cast information will be saved to the Musician Credits field. Note that the formatting of the credits depends on the setting you made in Preferences - Video.
Collection name
  If the movie is part of a collection, its name will be saved to a UDTI named tMDb Collection Name.
Crew
  All available crew information will be saved to the Involved People field. Note that crew includes all non acting roles such as director, producer, etc.
Genres
  All available genre information will be saved to the Genre field.
Homepage
  If available the homepage URL will be saved as a Commercial Information Webpage.
IMDB ID
  If available the IMDB ID will be saved to a UDTI named IMDB ID. Note that Yate does not currently use this information.
Medis Type
  The Media Type field will be set to Movie.
Movie Description
  The movie's description will be saved to the Video Description field.
Movie ID
  The movie's tMDb ID will be saved to a UDTI named tMDb Movie ID. Note that Yate does not currently use this information after importing.
Original Language
  The original language of the movie will be saved as an ISO 639-1 language code code to a UDTI named tMDb Original Language (ISO).
Original Title
  The original title of the movie will be saved to the Original Filename/Title field.
Production Companies
  All available production companies will be saved to the Label field.
Production Countries
  The list of production countries (full names) will be saved to a UDTI named tMDb Production Countries.
Production Countries (ISO)
  The list of production countries (ISO 3166-1 alpha-2 country codes) will be saved to a UDTI named tMDb Production Countries (ISO).
Release Date
  The movie's release date will be saved in its entirety to the Release Time and Year fields.
Revenue
  The revenue, if available, will be saved to a UDTI named tMDb Revenue.
Spoken Languages
  All available spoken languages (full names) will be saved to a UDTI named tMDb Spoken Languages.
Spoken Languages (ISO)
  All available spoken languages (ISO 639-1 language codes) will be saved to a UDTI named tMDb Spoken Languages (ISO).
Tagline
  The movie's tagline will be saved to the Description field.
Title
  The possibly corrected title will be saved to the Title field.
Video Definition
  The Video Definition field will be set from the properties of the video stream.