Movie Lookup

Movie Lookup

Performs a movie metadata lookup using TheMovieDB.org.

This flow element searches TheMovieDB for information about a movie and stores the results in the VideoMetadata parameter.
The metadata can include details such as the movie’s title, original title, release date, overview, genres, runtime, poster, backdrop, spoken languages, and more.
This information can then be used by later elements in your flow to rename files, tag videos, or generate reports.

---

Use Folder Name

If enabled, the lookup will use the folder name instead of the filename when performing the search.
This is useful when your files are stored in folders named after the movie (for example, /Movies/Inception (2010)/movie.mkv).
In such cases, using the folder name can improve accuracy, especially if the file itself has extra tags or unrelated words in its filename.

---

Use Spoken Language

If enabled, the first spoken language from TheMovieDB will be used as the Original Language of the movie.
By default, TheMovieDB provides an original language field, which may represent the production language rather than the language spoken in the film.
Enabling this option ensures that the language reported matches what is actually spoken on screen — for example, a Japanese film produced by a French company will correctly show Japanese as the original language rather than French.

---

Language

An optional ISO 639-1 language code used to control which language TheMovieDB returns metadata in.
For example, use en for English, fr for French, or de for German.
If no language is specified, English (en) will be used by default.
This affects the language of fields like the movie title, overview, and genre names, but does not change the Original Language or Spoken Language values themselves.

---

Variables

Variable	Description	Type	Example
movie.Title	The movie title	string	Batman Begins
movie.Year	The movie year	number	2005
movie.ImdbId	The movie IMDB ID if found	string	tt0372784
VideoMetadata	Object containing video metadata	object	see below

Outputs

1. Movie found
2. Movie not found

MovieInfo

    // the video title
    Title:string;
    // the video subtitle, e.g. a tv show episode title
    Subtitle:string;
    // the video description 
    Description:string;
    // the year the video was released
    Year:int;
    // the full date the video was released
    ReleaseDate:DateTime;
    // a file path to the video's art, e.g. a poster or episode thumbnail
    ArtJpeg:string;
    // the original language
    OriginalLanguage:string;
    // the season the episode belongs, or null if not a tv show
    Season:number;
    // the episode number in the season the episode belongs, or null if not a tv show
    Episode:number;
    // a list of actors in the video
    Actors:string[];
    // a list of directories who directed this video
    Directors:string[];
    // a list of writers who wrote this video
    Writers:string[];
    // a list of producers who produced this video
    Producers:string[];
    // a list of genres for this video
    Genres:string[];

---

Example Function

var movieInfo = Variables.VideoMetadata;

if(!movieInfo)
{
    Logger.WLog('Failed to get movie metadata');
    return 2;
}

if(movieInfo.Season === 2)
{
    Logger.ILog('Its season 2!')
    return 1;
}

return 1;