# The Movie DB - TV 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.

Note that this importer assumes that any file which contains video is a TV show in the same series. To search for metadata for movies use the The Movie DB - Movie Importer.

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. This importer is intended to work on a single show at a time. All selected files which contain video will be assumed to be an episode of the same show. All episodes (files) must either have data in the Season and Episode fields or have date formatted as S##E## in the filename.

You must first search the database by specifying the metadata to be used. The Show field is the only mandatory field. The field will be populated with a consistant Show Name field or a consistant show name extracted from the filename. 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 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 files.

After importing, the importer will terminate.

The following import settings are available:

Artwork - Episode - Still
  If available, an episode's still image will be imported. Note that depending on your Artwork scaling preferences, the image may be scaled down.
Artwork - Season - Poster
  If available, a season's poster image will be downloaded. Note that depending on your Artwork scaling preferences, the image may be scaled down.
Artwork Show - Backdrop
  If available, a show's backdrop image will be downloaded. Note that depending on your Artwork scaling preferences, the image may be scaled down.
Artwork Show - Poster
  If available, a show'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
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.
Crew
  All available crew information will be saved to the Involved People field. Note that crew includes all non acting roles such as creator, director, producer, etc.
Episode Description
  The episode description will be saved to the Video Description and Description fields.
Episode air date
  The episode's air date will be saved to the Release Time and Year fields.
Episode Title
  The episode's title will be saved to the Title field.
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.
Medi Type
  The Media Type field will be set to TV Show.
Network Names
  The network names will be saved to the Network Names field.
Original Language (ISO)
  The original language of the show will be saved as an ISO 639-1 language code code to a UDTI named tMDb Original Language.
Original Show Name
  The original show name will be saved to the Original Filename/Title field.
Production Companies
  All available production companies will be saved to the Label field.
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).
Season/episode numbers
  The season and episode numbers, which might have been extracted from a filename, will be imported to the Season and Episode fields.
Season Description
  The season description, if available, will be appended to the imported Show description. If Show description is not imported, this setting is ignored.
Show description
  The show description will be imported to the Show Description field.
Show first air date
  The first air date for the show will be saved to the Original Release Time field.
Show name
  The show's name will be saved to the Show Name field.
Spoken Languages (ISO)
  All available spoken languages (ISO 639-1 language codes) will be saved to a UDTI named tMDb Spoken Languages (ISO).
TV ID
  The show's tMDb ID will be saved to a UDTI named tMDb TV ID. Note that Yate does not currently use this information after importing.
Video Definition
  The Video Definition field will be set from the properties of the video stream.