MMS operations

93.2.1.26 MMS - TMDB Integration

MMS - TMDB Integration is the action used by the ETERE system to integrate The Movie Database (TMDb) API into the ETERE system. This action makes HTTP requests and, based on the JSON responses, imports MOVIE metadata into the asset. 

MMS - TMDB - General

MMS - TMDB Integration

To create this action, the following fields must be filled.


GENERAL TAB

Name: Give it a short name to identify the action.
Operation: Select "TMDB Integration" option.


DESTINATION
Device: Select the destination device to which the files would be copied.
Path: If the selected cloud device contains more than one path, this parameter allows one to choose one of them as the destination path.
Codec: Select the destination codec where the files would be copied to.
Filename: Choose, among the following options, how the destination filename should be managed.
• Asset ID: Rename the file as the ID of the asset to which the wf is attached.
• Asset code: Rename the file as the asset code to which the wf is attached.
• Asset code + type: Rename the file as the code and the type of the asset to which the wf is attached.
• Generate a unique name: The physical file will be named using a unique identification (UID) automatically generated by a system algorithm.
By default, one unique name is generated for each metafile; therefore, in case the file is formed by multiple physical files (e.g. mpg, pd, vix), Etere DataMover will use the same UID for all files but different extensions; for instance, the files 2143.mpg, 2143. vix and 2143.pd will become 02BD0000000000000075.mpg, 02BD0000000000000075.vix, 02BD0000000000000075.PD.
If the metafile name is changed, Etere DataMover will use the same UID for both the file and the metafile, thus allowing the support of video servers on which video files are managed, maintaining a relationship between the name of metafiles and physical files.
• Use custom rules: The file will be named with a custom filename based on database references (e.g.  Flexi-metadata, asset data...) and free text.
Note: If in the RENAME action, a rule is used that must take the value from a flexi that contains characters not supported by the operating system (such as | \ / : * ") ETERE automatically replaces them with the character - (hyphen)
• Extension: This parameter allows modification of the extension of the destination file, activating the "Change" flag and typing it in the field.


OPTIONS
Concurrent processes: Indicate the maximum number of actions that can be taken at the workstation simultaneously.
Do not use media folders even if configured: Enable this option to ignore the translated path, even if it's configured.
Never update DB files: The file won't be updated in the database.
Update all assets linked to the source file: If enabled (default), the copied file will be associated with all the asset forms linked to the source file.
Enabling this option is useful, for instance, when a single file is used by multiple assets (e.g. which transmit it overlaid with different logos); in this case, every time the file is copied, the new copy will be updated across all linked assets.
If disabled, the copied file will be associated only with the asset form for which the T-workflow has been launched.
Disabling this option is useful, for instance, when a single big file (e.g. a live feed recording) is used by multiple assets which partially retrieve a smaller file; in this case, only the support from which the partial retrieve has been executed will be updated.
Use SSL: Enable this option to use SSL (Secure Socket Layer) when saving the file in a destination path over the network. If enabled, the service media manager would attempt to complete the action using the following authentication steps in sequential order:
- FTP over TLS (Transport Layer Security)
- FTP over SSL (Secure Socket Layer)
- Plain FTP (without encryption)
If the FTP server supports SSL encryption, the Media Manager service will use a new set of libraries for copying files. Else, Plain FTP would be used.
Use passive mode: If checked, the FTP client will try to use passive mode for all file transfers (upload/download/move); otherwise (if disabled), the standard active way will be used.
Use "passive server to server" when moving between FTP servers: Enable this option if both source and destination devices use the FTP protocol and support 'passive mode'.


TMDB INTEGRATION

API PARAMETERS

In this section, the correct TMDB API credentials must be entered in order to allow ETERE to perform the appropriate API calls and receive the corresponding responses.

Api Key: digit the correct API Key obtained from https://www.themoviedb.org/settings/api after registering and logging in.

Language: select the language to be used for metadata insertion.

Process:

Update metadata: select whether you want to update or create metadata only for the single asset, for the season, for the series, or for all levels.

Update revenue only: select this option if you want to update only the flexi metadata revenue.

NB: ETERE creates TMDB's flexies by default. You have to enable them to be used for the actions and users.


API OPTIONS

Exact title match: If enabled, the system searches content on TMDB using an exact title match. This reduces the risk of incorrect matches but may limit results if titles differ due to variations or translations.

Update metadata: If enabled, existing metadata in ETERE will be updated with data retrieved from TMDB.   If disabled, metadata will only be created if not already present, avoiding overwriting existing data.

Import Keywords: Select this option to import keywords associated with the content from TMDB.  Keywords can be used for classification, advanced search, and content organization.

Add Artist: select whether you want to update or create artists related to the single asset, the season, the series, or all levels. This option enriches metadata with information about actors, directors, and other contributors.

Add Genre: Select this option to update or create genres at all levels of the series.  Genres are imported from TMDB and automatically assigned to the content, improving categorization.


POSTER OPTIONS

In this section, the settings related to posters to be downloaded from the TMDB website must be configured. The files will be downloaded to the path specified in the GENERAL tab.

Download: set the values to download posters by selecting MAIN only, ALL, or NONE, choosing whether the operation applies to series and/or seasons.

File suffix: specify a suffix to be added to the metafile created by ETERE. For example, if _POSTER is specified, each linked poster will be renamed as ID_POSTER.

Codec: set the correct codec to be assigned to each poster. Is Advisable to create a codec related to the Posters.

Size (If available): specify the size value used to download the image from the website. It is recommended to leave the value set to Original.


BACKDROPS OPTIONS

In this section, the settings related to Backdrops to be downloaded from the TMDB website must be configured. The files will be downloaded to the path specified in the GENERAL tab.

Download: set the values to download Backdrops by selecting MAIN only, ALL, or NONE, choosing whether the operation applies to series and/or seasons.

File suffix: specify a suffix to be added to the metafile created by ETERE. For example, if _BACKDROP is specified, each linked backdrop will be renamed as ID_BACKDROP.

Codec: set the correct codec to be assigned to each logo. Is Advisable to create a codec related to the Backdrops.

Size (If available): specify the size value used to download the image from the website. It is recommended to leave the value set to Original.


LOGOS OPTIONS

In this section, the settings related to Logos to be downloaded from the TMDB website must be configured. The files will be downloaded to the path specified in the GENERAL tab.

Download: set the values to download Logos by selecting ALL or NONE, choosing whether the operation applies to series and/or seasons.

File suffix: specify a suffix to be added to the metafile created by ETERE. For example, if _LOGO is specified, each linked backdrop will be renamed as ID_LOGO.

Codec: set the correct codec to be assigned to each Logo. Is Advisable to create a codec related to the Logos.

Size (If available): specify the size value used to download the image from the website. It is recommended to leave the value set to Original.

It is always advisable to follow this procedure to avoid any issues:

1- Create the MASTER SERIES

2- Create the SEASON

3- Link the SEASON to the MASTER SERIES

4- Add the episodes

5- Run the workflow for TMDB integration on all episodes


ABOUT:

Multiple results handling: If multiple results are found on TMDB, the action will return a message indicating that multiple matches have been detected, including the corresponding unique TMDB IDs.

To update an asset in case of multiple results:

  1. Open the asset in ETERE.
  2. Go to the Metadata tab.
  3. Select the TMDB Flexies page.
  4. Enter the correct TMDB ID in the TMDB ID flexi field.
  5. Save the changes.

Once completed, run the TMDB workflow again. Based on the manually entered TMDB ID, the system will retrieve the correct information from TMDB and update the metadata according to the configured settings.


Master Serie: If a season is not linked to any Master Series, the system will create one for each season.

Since there are no validation checks, duplicate entries may be created. For this reason, it is recommended to first create the Master Series and then link the corresponding seasons to it.


Season Title: The season title will be renamed based on the series name and the season name itself. For example, if the operator creates the series ETERE and links the season ETERE S1 to it, the system will query the TMDB APIs and perform cross-checks such as the series name and the creation year.

If the API response indicates that the correct season name is FIRST ACT, the system will rename the season using the format MASTER SERIES + SEASON NAME.

In this example, the resulting name will be: ETERE - FIRST ACT.


Asset Title: The asset title will always be renamed using the correct title provided by the TMDB website, based on the API response.


Trailer: when launched on an episode, the ETERE workflow will always create the series trailer and the season trailer - if not present - linking to them the available posters, backdrops, and logos.


Artist: Based on the API response and the ETERE rules, artists will be updated and/or created (if they do not already exist and if the option is enabled) for each series, season, and episode. Artists will be visible depending on the level they belong to: series, season, or asset. Note that an artist appearing in a single episode may not necessarily appear in another episode; however, the artist will still be associated with the series.

MMS_-_TMDB_-_General
TMDB_INTEGRATION
TMDB_FLEXI-METADATA