Metadata 101

Infuse supports a wide variety of naming formats, and will fetch info for most titles automatically.

File Naming Styles

Movies

Note: Release year is not required, but it can be used for better results.

Option 1. Individual movies

Pulp Fiction (1994).mkv
Inception.avi
Captain-America-The-Winter-Soldier-2014.mp4

Option 2. Grouped into folders (files other than video optional)

/Movies/Pulp Fiction
> Pulp Fiction (1994).mkv
> Pulp Fiction (1994).srt
> Pulp Fiction (1994).jpg
> Pulp Fiction-fanart.jpg
> Pulp Fiction.nfo
/Movies/Inception
> Inception.avi
> Inception.srt
> Inception.jpg
> Inception-fanart.jpg
> Inception.xml

Custom metadata can be set by adding an XML file. A sample can be found here.

TV shows

  1. show-name_s01e02.mkv
  2. show-name_s1e2.mkv
  3. show-name_s01.e02.mkv
  4. show-name_s01_e02.mkv
  5. show-name_1x02.mkv
  6. show name/any folder/S01E02.mkv
  7. show name/any folder/01.02.mkv
  8. show name/season 1/02.mkv
  9. show name/season 1/1-02.mkv
  10. show name/season 1/episode 02.mkv

Note: Period, space, underscore and dash can all be used interchangeably as separator characters.

Note 2: For episodes classified as a 'special' a season number of 0 should be used.

Note 3: Option 6-9 cannot be used with Google Drive.

Optional: Grouped into folders by series/season

TV Shows/The Big Bang Theory

> Season 1

> Files
> Season 2
> Files
> Season 3
> Files
TV Shows/The Office
> Season 1
> Files
> Season 2
> Files
> Season 3
> Files

Overriding TV series, season, and episode artwork
Use your own artwork for TV series, season, and episode artwork. Overriding series/season artwork is available when episodes are organized into folders by season (Series Name/Season X/episodes.mkv).
E.G. Breaking Bad/Season 1/Breaking Bad S01E01.mkv
Usage details
Episode poster
seriesname/season 1/episodefilename.jpg
Season poster
seriesname/season 1-poster.jpg
All Seasons poster
seriesname/season-all-poster.jpg
Series poster (available only while using Library)
seriesname/poster.png

Series fanart
seriesname/fanart.png

Folder artwork

Folder artwork can be set by adding a folder.png or folder.jpg file to any folder (1000 x 1500 recommended size).

Custom artwork can also be added to local folders created within Infuse by uploading a folder image via FTP or Wi-Fi Browser upload.

Favorite artwork

Custom artwork can be set for favorites by adding the following images inside the folder based favorite.

favorite-atv.png or favorite-atv.jpg - used on Apple TV, and in list view on iOS (1920 x 1080 recommended size)

favorite.png or favorite.jpg - used on iOS (1000 x 1500 recommended size)

Note: Favorite artwork can be set for folders (including UPnP/DLNA) and Library filters by following the steps found here.

Excluding folders and extras

If you have folders or extras you don't want listed in the library, there are a few options available which will prevent Infuse from indexing these.

  1. Support Kodi's '.nomedia' file. If present in a folder, Infuse would not index videos in that folder.
  2. Ignore folders named 'extras' as documented by Kodi.
  3. Ignore files and folders that follow Plex's extras naming schemes.

Making manual corrections (iOS)

Step 1. While viewing the incorrectly matched item's ticket view, tap the 3 dots icon and select Edit Metadata.

Step 2. Tapping this option will reveal a list of possible matches.

Note: If the correct title is not listed, the search box can be used to search for a title manually.

Step 3. Select the correct title, and Infuse will download and update all metadata and artwork automatically.

Making manual corrections (Apple TV)

Step 1. While viewing the incorrectly matched item's details page, select the 'Edit' button.

Step 2. Selecting this option will reveal a list of possible matches.

Note: If the correct title is not listed, the search box can be used to search the entire TMDb.

Step 3: Select the correct title, and Infuse will download and update all metadata and artwork automatically.

Using embedded metadata & artwork

You can avoid movie/tv show matching to better handle things like home videos. This can be done by enabling the global 'Embedded Metadata' option found in Settings. This setting can also be set on a folder-by-folder basis by following these steps.

iOS - While browsing inside the folder you wish to use embedded metadata for, tap the 3 dots in the upper right corner and select 'Use Local Metadata'. To switch back, follow the same process and select 'Use Online Metadata'.

tvOS - While browsing, long-press on the folder of favorite you wish to use embedded metadata for and select 'Use Local Metadata'. To switch back, follow the same process and select 'Use Online Metadata'.

Note: When local metadata is enabled for a folder on tvOS, you will see the words 'Local Metadata' in the upper right corner.