Catalog Import Requirements

Technical specifications for large catalogs to upload titles into the Filmhub ecosystem

 

In this guide:

• Asset Requirements
• Metadata & Avails
• File paths and organization
  • How to find a file's path

---

Asset Requirements

Provide assets using these specs. More detailed technical information can be found on the Filmhub Asset Requirements page.

The table below shows which types of assets are supported for each format (movie, show, season, or episode). Some things to keep in mind:

• Movies support all asset types.
• Shows only support one trailer and one set of title artwork.
  All episodes and seasons of a show share the same trailer and title art.
• Textless artwork is supported for all asset types, but is not required for any of them.

Find out more about preparing and delivering assets in bulk in Catalog Import: Asset Transfers.

Metadata & Avails

Metadata & Avails Template

We need clear and accurate metadata for each title in a table so we can automatically fill in title descriptions, cast and crew, tags, avails, and other metadata in bulk. The columns in the table will map to each title's Profile and Listing pages: Profile metadata and Listing metadata.

Avails can be defined by blocked channel, territory, date, and licensing type. Contact your acquisitions executive for titles with more complex avails.  

Seasons and episodes inherit most of their metadata from their parent show. This metadata appears blacked out in the template, and can be left blank. Seasons and episodes can only have unique names, descriptions, release dates, and file paths.

File paths and organization

When preparing assets for delivery, organize the files into a folder for each title. Each title's package should contain only and all assets unique to its title. In order for us to confirm which file in the delivery belongs to what title, we ask for file paths for each asset, as any business would request a packing slip or manifest with their order.

A file path tells you which folder → sub-folder → AND filename to navigate through to arrive at the specified file. The path starts with the name of the package folder, followed by any subfolders if they exist, ending with the full name of the file with its extension. 

Structure: [folder] / [sub-folder] / [filename]
Example: TitleName/Videos/MyMovie_en_1080.mp4

Movie Example for File Path Structuring

We don't mandate any naming convention or structure, but here is a common example. Consider delivering assets for the movie, Pinocchio:

For this example, these are some of the paths:

• Main video: Pinocchio/VIDEO/Pinocchio_main.mp4
• Captions: Pinocchio/CAPTIONS/Pinocchio_en.srt
• Trailer: Pinocchio/VIDEO/Pinocchio_trailer.mp4
• 2x3 Artwork: Pinocchio/ARTWORK/Pinocchio_2x3.jpg

Delivering well-organized and labeled assets, along with precise file paths, will ensure titles are submitted as fast as possible.

How to get the file path for each of your files

Most operating systems show file paths down to the bottom of the entire system structure. That said, you only need to provide the relative path starting from the title folder.

In the following examples for both Mac and Windows PC, the part of the path that we need is BOLDED.

• Windows Explorer shows the current path in the navigation bar.
  • You can also right click over the file and hit "Properties" to find the file’s Location property, which is its path.

C:\Users\my-user\Filmhub-delivery-package\Pinocchio\ARTWORK\Pinocchio_2x3.jpg

• Mac OS Finder - go to View → Show Path Bar to see the path along the bottom of the window.
  • You can also hit Command + i on a file to open the Get Info window to find the file’s Where property, which is its path.
• The folders in the path will be separated by little arrow symbols, but copy and pasting it will render forward slashes:

/Volumes/harddrive/Users/my-user/Filmhub-delivery-package/Pinocchio/ARTWORK/Pinocchio_2x3.jpg

For more information about delivering assets, see this article: Catalog Import: Asset Transfer Process