29 Exporter Guide
JonnyWong16 edited this page 2024-11-24 15:05:08 -08:00

Contents:


Introduction

The exporter feature of Tautulli allows you to export metadata and media info from your Plex library. The exporter can be accessed from various locations:

  1. On any library page from the Collections, Playlists, or Export tabs. This will allow you to export all of your collections, playlists or all items for any library on your Plex server.
  2. On any user page from the Playlists tab. This will allow you to export all of a user's playlists for any user on your Plex server.
  3. On any media info page from the Export tab. This will allow you to export the metadata for any single media item on your Plex server.

Clicking on the export button on any of those pages will open up the export metadata modal where you can customize your export. All the customization options are described in the sections below.

The metadata exports table on the library, user, or media info page will list all your previous exports and allow you to view or download a copy of the exported files. The download will return the exported file if only a single data file is exported, otherwise the download will return a zip archive containing all the exported data files and images. A progress percentage will be shown in the downloads column while an export is in progress. Exports are processed in the background so you may leave the page and check back later when it is complete.

  • Note: The exporter only exports metadata. There is no import feature available in Tautulli.

File Formats

Metadata can be exported to various file formats. Notes about each file format is listed in the following table.

File Format Description
csv Export a comma-separated values file.
  • Note: Each row in the csv file is unique so there may be multiple rows for the same media item (e.g. each genres.tag will be on it's own row so a single movie may have multiple rows).
json Export a json format file.
xml Export a xml format file.
m3u Only export a m3u playlist file with the paths to all the media items without any additional metadata.
  • Note: All files will be added to the playlist if there are multiple parts/versions.
  • Note: Export level selections are not allowed.

Export Individual Files

Enable this option to export one file for each collection/playlist/library item instead of a single file containing all items.

  • Note: This option is only available when exporting collections, playlists or all items from the library or user page.

Metadata and Media Info Exports

The exporter has several predefined export levels. The export levels are separated into metadata levels which include fields about the metadata of the item (e.g. title, year, summary, etc.) and media info levels which include fields about the media file (e.g. media.videoResolution, media.audioCodec, media.hdr, etc.). The metadata level and media info level can be different, and the same level does not need to be selected for both. Higher levels will include all the fields from the lower levels. The fields that will be exported for each level are listed in the Media Type Fields sections below.

Metadata and Media Info Export Levels

Metadata Export Level Name Description
Level 0 None / Custom No metadata will be exported. Specify custom metadata fields to select which fields to export.
Level 1 Basic Metadata Only basic metadata such as title, year, summary, etc.
Level 2 Extended Metadata Tags such as genres.tag, collections.tag, roles.tag, etc.
Level 3 Advanced Metadata Fields such as Plex API keys for art, thumb, theme, etc.
Level 9 All Metadata All metadata will be exported.
Media Info Export Level Name Description
Level 0 None / Custom No media info will be exported. Specify custom media info fields to select which fields to export.
Level 1 Basic Media Info Only basic media info such as media.bitrate, media.videoCodec, media.audioChannels, etc.
Level 2 Extended Media Info Fields for the specific media file part such as media.parts.size, media.parts.duration, etc.
Level 3 Advanced Media Info Fields for specific streams inside a media file part such as
media.parts.videoStream.refFrames, media.parts.audioStream.samplingRate, media.parts.subtitleStream.language, etc.
Level 9 All Media Info All media info will be exported.

Custom Fields

Custom fields can be added in addition to any export level. All fields from the selected metadata or media info level plus the custom fields will be exported. Start typing in the custom field box to search for a specific field to add. Some fields will be disabled to indicate that it is already included in the selected export level. All the available fields are listed in the Media Type Fields sections below.

  • Note: Custom fields for child media types are prefixed with the media type and separated with periods (.). The periods also delineate the tree structure in the json or xml file.

    • e.g. The seasons.episodes.title field will export the episode title for all seasons and all episodes for a TV show.
  • Note: For Collections and Playlists, the items prefix can be different media types depending on the context. Refer to the Media Type Fields sections below for all the possible media types.

    • e.g. The items.title field will be the movie title in a movie collection or TV show titles in a TV show collection.

Image Exports

Poster/cover images and background artwork can be exported along with the metadata. Images will be exported to a .images folder alongside the data file with the extension .thumb.jpg for posters/covers, .art.jpg for background artwork, and .logo.jpg for logos. When downloading an export from the metadata exports table, the images will be included in a zip archive with the data file.

  • Warning: Exporting images may take a long time!

  • Note: Images will only be exported by the selected image export level for the following supported media types:

    • Movies, shows, seasons, artists, albums, collections and collection items, playlist items
  • Note: Additional images for any media type can be exported by adding thumbFile for posters/covers, artFile for background artwork, and logoFile for logos to the custom metadata fields. Adding the custom field will export all images of that type regardless of the selected image export level.

    • e.g. Adding episodes.thumbFile to the custom metadata fields will export all episode thumbnails even though it is not included in the supported image export media types.

Image Export Levels

Poser and Cover Image Export Level Name Description
Level 0 None / Custom No poster/cover images will be exported. Specific posters/covers can be exported by adding thumbFile to the custom metadata fields.
Level 1 Uploaded and Selected Posters and Covers Only Only custom poster/cover images which have been uploaded manually and are currently selected as the active poster/cover.
Level 2 Selected and Locked Posters and Covers Only Only currently selected poster/cover images which have been changed from the default poster/cover.
Level 9 All Selected Posters and Covers All poster/cover images for the supported media types.
Background Artwork Image Export Level Name Description
Level 0 None / Custom No background artwork images will be exported. Specific background art can be exported by adding artFile to the custom metadata fields.
Level 1 Uploaded and Selected Artwork Only Only custom background artwork images which have been uploaded manually and are currently selected as the active artwork.
Level 2 Selected and Locked Artwork Only Only currently selected background artwork images which have been changed from the default artwork.
Level 9 All Selected Artwork All background artwork images for the supported media types.
Logo Image Export Level Name Description
Level 0 None / Custom No logo images will be exported. Specific logos can be exported by adding logoFile to the custom metadata fields.
Level 1 Uploaded and Selected Logos Only Only custom logo images which have been uploaded manually and are currently selected as the active artwork.
Level 2 Selected and Locked Logos Only Only currently selected logo images which have been changed from the default logo.
Level 9 All Selected Logos All logo images for the supported media types.

Media Type Fields

Movies

Metadata Fields
Metadata Field Level 0 Level 1 Level 2 Level 3 Level 9
addedAt
art
artBlurHash
artFile Refer to Image Exports
artProvider
audienceRating
audienceRatingImage
chapterSource
contentRating
duration
durationHuman
editionTitle
enableCreditsMarkerGeneration
guid
hasCreditsMarker
hasPreviewThumbnails
hasVoiceActivity
key
languageOverride
lastRatedAt
lastViewedAt
librarySectionID
librarySectionKey
librarySectionTitle
logo
logoFile Refer to Image Exports
logoProvider
metadataDirectory
originalTitle
originallyAvailableAt
rating
ratingImage
ratingKey
slug
studio
summary
tagline
theme
thumb
thumbBlurHash
thumbFile Refer to Image Exports
thumbProvider
title
titleSort
type
updatedAt
useOriginalTitle
userRating
viewCount
viewOffset
year
chapters.end
chapters.id
chapters.index
chapters.start
chapters.tag
chapters.thumb
collections.id
collections.tag
countries.id
countries.tag
directors.id
directors.tag
fields.locked
fields.name
genres.id
genres.tag
guids.id
labels.id
labels.tag
markers.end
markers.final
markers.first
markers.id
markers.start
markers.type
producers.id
producers.tag
roles.id
roles.role
roles.tag
roles.thumb
writers.id
writers.tag
Media Info Fields
Media Info Field Level 0 Level 1 Level 2 Level 3 Level 9
locations
media.aspectRatio
media.audioChannels
media.audioCodec
media.audioProfile
media.bitrate
media.container
media.duration
media.has64bitOffsets
media.hasVoiceActivity
media.hdr
media.height
media.id
media.isOptimizedVersion
media.optimizedForStreaming
media.proxyType
media.target
media.title
media.videoCodec
media.videoFrameRate
media.videoProfile
media.videoResolution
media.width
media.parts.accessible
media.parts.audioProfile
media.parts.container
media.parts.deepAnalysisVersion
media.parts.duration
media.parts.exists
media.parts.file
media.parts.has64bitOffsets
media.parts.hasPreviewThumbnails
media.parts.hasThumbnail
media.parts.id
media.parts.indexes
media.parts.key
media.parts.optimizedForStreaming
media.parts.packetLength
media.parts.requiredBandwidths
media.parts.size
media.parts.sizeHuman
media.parts.syncItemId
media.parts.syncState
media.parts.videoProfile
media.parts.audioStreams.audioChannelLayout
media.parts.audioStreams.bitDepth
media.parts.audioStreams.bitrate
media.parts.audioStreams.bitrateMode
media.parts.audioStreams.channels
media.parts.audioStreams.codec
media.parts.audioStreams.default
media.parts.audioStreams.displayTitle
media.parts.audioStreams.duration
media.parts.audioStreams.extendedDisplayTitle
media.parts.audioStreams.id
media.parts.audioStreams.index
media.parts.audioStreams.key
media.parts.audioStreams.language
media.parts.audioStreams.languageCode
media.parts.audioStreams.languageTag
media.parts.audioStreams.profile
media.parts.audioStreams.requiredBandwidths
media.parts.audioStreams.samplingRate
media.parts.audioStreams.selected
media.parts.audioStreams.streamIdentifier
media.parts.audioStreams.streamType
media.parts.audioStreams.title
media.parts.audioStreams.type
media.parts.subtitleStreams.canAutoSync
media.parts.subtitleStreams.codec
media.parts.subtitleStreams.container
media.parts.subtitleStreams.default
media.parts.subtitleStreams.displayTitle
media.parts.subtitleStreams.extendedDisplayTitle
media.parts.subtitleStreams.forced
media.parts.subtitleStreams.format
media.parts.subtitleStreams.headerCompression
media.parts.subtitleStreams.id
media.parts.subtitleStreams.index
media.parts.subtitleStreams.key
media.parts.subtitleStreams.language
media.parts.subtitleStreams.languageCode
media.parts.subtitleStreams.languageTag
media.parts.subtitleStreams.providerTitle
media.parts.subtitleStreams.requiredBandwidths
media.parts.subtitleStreams.score
media.parts.subtitleStreams.selected
media.parts.subtitleStreams.sourceKey
media.parts.subtitleStreams.streamType
media.parts.subtitleStreams.title
media.parts.subtitleStreams.transient
media.parts.subtitleStreams.type
media.parts.subtitleStreams.userID
media.parts.videoStreams.DOVIBLCompatID
media.parts.videoStreams.DOVIBLPresent
media.parts.videoStreams.DOVIELPresent
media.parts.videoStreams.DOVILevel
media.parts.videoStreams.DOVIPresent
media.parts.videoStreams.DOVIProfile
media.parts.videoStreams.DOVIRPUPresent
media.parts.videoStreams.DOVIVersion
media.parts.videoStreams.anamorphic
media.parts.videoStreams.bitDepth
media.parts.videoStreams.bitrate
media.parts.videoStreams.cabac
media.parts.videoStreams.chromaLocation
media.parts.videoStreams.chromaSubsampling
media.parts.videoStreams.codec
media.parts.videoStreams.codecID
media.parts.videoStreams.codedHeight
media.parts.videoStreams.codedWidth
media.parts.videoStreams.colorPrimaries
media.parts.videoStreams.colorRange
media.parts.videoStreams.colorSpace
media.parts.videoStreams.colorTrc
media.parts.videoStreams.default
media.parts.videoStreams.displayTitle
media.parts.videoStreams.duration
media.parts.videoStreams.extendedDisplayTitle
media.parts.videoStreams.frameRate
media.parts.videoStreams.frameRateMode
media.parts.videoStreams.hasScalingMatrix
media.parts.videoStreams.hdr
media.parts.videoStreams.height
media.parts.videoStreams.id
media.parts.videoStreams.index
media.parts.videoStreams.key
media.parts.videoStreams.language
media.parts.videoStreams.languageCode
media.parts.videoStreams.languageTag
media.parts.videoStreams.level
media.parts.videoStreams.pixelAspectRatio
media.parts.videoStreams.pixelFormat
media.parts.videoStreams.profile
media.parts.videoStreams.refFrames
media.parts.videoStreams.requiredBandwidths
media.parts.videoStreams.scanType
media.parts.videoStreams.selected
media.parts.videoStreams.streamIdentifier
media.parts.videoStreams.streamType
media.parts.videoStreams.title
media.parts.videoStreams.type
media.parts.videoStreams.width

Shows

Metadata Fields
Metadata Field Level 0 Level 1 Level 2 Level 3 Level 9
addedAt
art
artBlurHash
artFile Refer to Image Exports
artProvider
audienceRating
audienceRatingImage
audioLanguage
autoDeletionItemPolicyUnwatchedLibrary
autoDeletionItemPolicyWatchedLibrary
childCount
contentRating
duration
durationHuman
enableCreditsMarkerGeneration
episodeSort
flattenSeasons
guid
index
key
languageOverride
lastRatedAt
lastViewedAt
leafCount
librarySectionID
librarySectionKey
librarySectionTitle
logo
logoFile Refer to Image Exports
logoProvider
metadataDirectory
network
originalTitle
originallyAvailableAt
rating
ratingKey
seasonCount
showOrdering
slug
studio
subtitleLanguage
subtitleMode
summary
tagline
theme
thumb
thumbBlurHash
thumbFile Refer to Image Exports
thumbProvider
title
titleSort
type
updatedAt
useOriginalTitle
userRating
viewCount
viewedLeafCount
year
collections.id
collections.tag
fields.locked
fields.name
genres.id
genres.tag
guids.id
labels.id
labels.tag
roles.id
roles.role
roles.tag
roles.thumb
seasons
Includes Seasons Level 1

Includes Seasons Level 2

Includes Seasons Level 3

Includes Seasons Level 9
Media Info Fields
Media Info Field Level 0 Level 1 Level 2 Level 3 Level 9
locations
seasons
Includes Seasons Level 1

Includes Seasons Level 2

Includes Seasons Level 3

Includes Seasons Level 9

Seasons

Metadata Fields
Metadata Field Level 0 Level 1 Level 2 Level 3 Level 9
addedAt
art
artBlurHash
artFile Refer to Image Exports
artProvider
audioLanguage
guid
index
key
lastRatedAt
lastViewedAt
leafCount
librarySectionID
librarySectionKey
librarySectionTitle
metadataDirectory
parentGuid
parentIndex
parentKey
parentRatingKey
parentStudio
parentTheme
parentThumb
parentTitle
ratingKey
seasonNumber
slug
subtitleLanguage
subtitleMode
summary
thumb
thumbBlurHash
thumbFile Refer to Image Exports
thumbProvider
title
titleSort
type
updatedAt
userRating
viewCount
viewedLeafCount
year
collections.id
collections.tag
fields.locked
fields.name
guids.id
labels.id
labels.tag
episodes
Includes Episodes Level 1

Includes Episodes Level 2

Includes Episodes Level 3

Includes Episodes Level 9
Media Info Fields
Media Info Field Level 0 Level 1 Level 2 Level 3 Level 9
episodes
Includes Episodes Level 1

Includes Episodes Level 2

Includes Episodes Level 3

Includes Episodes Level 9

Episodes

Metadata Fields
Metadata Field Level 0 Level 1 Level 2 Level 3 Level 9
addedAt
art
artBlurHash
artFile
artProvider
audienceRating
audienceRatingImage
chapterSource
contentRating
duration
durationHuman
episodeNumber
grandparentArt
grandparentGuid
grandparentKey
grandparentRatingKey
grandparentTheme
grandparentThumb
grandparentTitle
guid
hasCommercialMarker
hasCreditsMarker
hasIntroMarker
hasPreviewThumbnails
hasVoiceActivity
index
key
lastRatedAt
lastViewedAt
librarySectionID
librarySectionKey
librarySectionTitle
metadataDirectory
originallyAvailableAt
parentGuid
parentIndex
parentKey
parentRatingKey
parentThumb
parentTitle
parentYear
rating
ratingKey
seasonEpisode
seasonNumber
slug
summary
thumb
thumbBlurHash
thumbFile
thumbProvider
title
titleSort
type
updatedAt
userRating
viewCount
viewOffset
year
chapters.end
chapters.id
chapters.index
chapters.start
chapters.tag
chapters.thumb
collections.id
collections.tag
directors.id
directors.tag
fields.locked
fields.name
guids.id
labels.id
labels.tag
markers.end
markers.final
markers.first
markers.id
markers.start
markers.type
producers.id
producers.tag
roles.id
roles.role
roles.tag
roles.thumb
writers.id
writers.tag
Media Info Fields
Media Info Field Level 0 Level 1 Level 2 Level 3 Level 9
locations
media.aspectRatio
media.audioChannels
media.audioCodec
media.audioProfile
media.bitrate
media.container
media.duration
media.has64bitOffsets
media.hasVoiceActivity
media.hdr
media.height
media.id
media.isOptimizedVersion
media.optimizedForStreaming
media.proxyType
media.target
media.title
media.videoCodec
media.videoFrameRate
media.videoProfile
media.videoResolution
media.width
media.parts.accessible
media.parts.audioProfile
media.parts.container
media.parts.deepAnalysisVersion
media.parts.duration
media.parts.exists
media.parts.file
media.parts.has64bitOffsets
media.parts.hasPreviewThumbnails
media.parts.hasThumbnail
media.parts.id
media.parts.indexes
media.parts.key
media.parts.optimizedForStreaming
media.parts.packetLength
media.parts.requiredBandwidths
media.parts.size
media.parts.sizeHuman
media.parts.syncItemId
media.parts.syncState
media.parts.videoProfile
media.parts.audioStreams.audioChannelLayout
media.parts.audioStreams.bitDepth
media.parts.audioStreams.bitrate
media.parts.audioStreams.bitrateMode
media.parts.audioStreams.channels
media.parts.audioStreams.codec
media.parts.audioStreams.default
media.parts.audioStreams.displayTitle
media.parts.audioStreams.duration
media.parts.audioStreams.extendedDisplayTitle
media.parts.audioStreams.id
media.parts.audioStreams.index
media.parts.audioStreams.key
media.parts.audioStreams.language
media.parts.audioStreams.languageCode
media.parts.audioStreams.languageTag
media.parts.audioStreams.profile
media.parts.audioStreams.requiredBandwidths
media.parts.audioStreams.samplingRate
media.parts.audioStreams.selected
media.parts.audioStreams.streamIdentifier
media.parts.audioStreams.streamType
media.parts.audioStreams.title
media.parts.audioStreams.type
media.parts.subtitleStreams.canAutoSync
media.parts.subtitleStreams.codec
media.parts.subtitleStreams.container
media.parts.subtitleStreams.default
media.parts.subtitleStreams.displayTitle
media.parts.subtitleStreams.extendedDisplayTitle
media.parts.subtitleStreams.forced
media.parts.subtitleStreams.format
media.parts.subtitleStreams.headerCompression
media.parts.subtitleStreams.id
media.parts.subtitleStreams.index
media.parts.subtitleStreams.key
media.parts.subtitleStreams.language
media.parts.subtitleStreams.languageCode
media.parts.subtitleStreams.languageTag
media.parts.subtitleStreams.providerTitle
media.parts.subtitleStreams.requiredBandwidths
media.parts.subtitleStreams.score
media.parts.subtitleStreams.selected
media.parts.subtitleStreams.sourceKey
media.parts.subtitleStreams.streamType
media.parts.subtitleStreams.title
media.parts.subtitleStreams.transient
media.parts.subtitleStreams.type
media.parts.subtitleStreams.userID
media.parts.videoStreams.DOVIBLCompatID
media.parts.videoStreams.DOVIBLPresent
media.parts.videoStreams.DOVIELPresent
media.parts.videoStreams.DOVILevel
media.parts.videoStreams.DOVIPresent
media.parts.videoStreams.DOVIProfile
media.parts.videoStreams.DOVIRPUPresent
media.parts.videoStreams.DOVIVersion
media.parts.videoStreams.anamorphic
media.parts.videoStreams.bitDepth
media.parts.videoStreams.bitrate
media.parts.videoStreams.cabac
media.parts.videoStreams.chromaLocation
media.parts.videoStreams.chromaSubsampling
media.parts.videoStreams.codec
media.parts.videoStreams.codecID
media.parts.videoStreams.codedHeight
media.parts.videoStreams.codedWidth
media.parts.videoStreams.colorPrimaries
media.parts.videoStreams.colorRange
media.parts.videoStreams.colorSpace
media.parts.videoStreams.colorTrc
media.parts.videoStreams.default
media.parts.videoStreams.displayTitle
media.parts.videoStreams.duration
media.parts.videoStreams.extendedDisplayTitle
media.parts.videoStreams.frameRate
media.parts.videoStreams.frameRateMode
media.parts.videoStreams.hasScalingMatrix
media.parts.videoStreams.hdr
media.parts.videoStreams.height
media.parts.videoStreams.id
media.parts.videoStreams.index
media.parts.videoStreams.key
media.parts.videoStreams.language
media.parts.videoStreams.languageCode
media.parts.videoStreams.languageTag
media.parts.videoStreams.level
media.parts.videoStreams.pixelAspectRatio
media.parts.videoStreams.pixelFormat
media.parts.videoStreams.profile
media.parts.videoStreams.refFrames
media.parts.videoStreams.requiredBandwidths
media.parts.videoStreams.scanType
media.parts.videoStreams.selected
media.parts.videoStreams.streamIdentifier
media.parts.videoStreams.streamType
media.parts.videoStreams.title
media.parts.videoStreams.type
media.parts.videoStreams.width

Artists

Metadata Fields
Metadata Field Level 0 Level 1 Level 2 Level 3 Level 9
addedAt
albumSort
art
artBlurHash
artFile Refer to Image Exports
artProvider
guid
index
key
lastRatedAt
lastViewedAt
librarySectionID
librarySectionKey
librarySectionTitle
metadataDirectory
rating
ratingKey
summary
theme
thumb
thumbBlurHash
thumbFile Refer to Image Exports
thumbProvider
title
titleSort
type
updatedAt
userRating
viewCount
collections.id
collections.tag
countries.id
countries.tag
fields.locked
fields.name
genres.id
genres.tag
guids.id
labels.id
labels.tag
moods.id
moods.tag
similar.id
similar.tag
styles.id
styles.tag
albums
Includes Albums Level 1

Includes Albums Level 2

Includes Albums Level 3

Includes Albums Level 9
Media Info Fields
Media Info Field Level 0 Level 1 Level 2 Level 3 Level 9
locations
albums
Includes Albums Level 1

Includes Albums Level 2

Includes Albums Level 3

Includes Albums Level 9

Albums

Metadata Fields
Metadata Field Level 0 Level 1 Level 2 Level 3 Level 9
addedAt
art
artBlurHash
artFile Refer to Image Exports
artProvider
guid
hasSonicAnalysis
index
key
lastRatedAt
lastViewedAt
leafCount
librarySectionID
librarySectionKey
librarySectionTitle
loudnessAnalysisVersion
metadataDirectory
musicAnalysisVersion
originallyAvailableAt
parentGuid
parentKey
parentRatingKey
parentTheme
parentThumb
parentTitle
rating
ratingKey
studio
summary
thumb
thumbBlurHash
thumbFile Refer to Image Exports
thumbProvider
title
titleSort
type
updatedAt
userRating
viewCount
viewedLeafCount
year
collections.id
collections.tag
fields.locked
fields.name
formats.id
formats.tag
genres.id
genres.tag
guids.id
labels.id
labels.tag
moods.id
moods.tag
styles.id
styles.tag
subformats.id
subformats.tag
tracks
Includes Tracks Level 1

Includes Tracks Level 2

Includes Tracks Level 3

Includes Tracks Level 9
Media Info Fields
Media Info Field Level 0 Level 1 Level 2 Level 3 Level 9
tracks
Includes Tracks Level 1

Includes Tracks Level 2

Includes Tracks Level 3

Includes Tracks Level 9

Tracks

Metadata Fields
Metadata Field Level 0 Level 1 Level 2 Level 3 Level 9
addedAt
art
artBlurHash
chapterSource
duration
durationHuman
grandparentArt
grandparentGuid
grandparentKey
grandparentRatingKey
grandparentTheme
grandparentThumb
grandparentTitle
guid
hasSonicAnalysis
index
key
lastRatedAt
lastViewedAt
librarySectionID
librarySectionKey
librarySectionTitle
metadataDirectory
musicAnalysisVersion
originalTitle
parentGuid
parentIndex
parentKey
parentRatingKey
parentThumb
parentTitle
ratingCount
ratingKey
skipCount
summary
thumb
thumbBlurHash
title
titleSort
trackNumber
type
updatedAt
userRating
viewCount
viewOffset
year
chapters.end
chapters.id
chapters.index
chapters.start
chapters.tag
chapters.thumb
collections.id
collections.tag
fields.locked
fields.name
genres.id
genres.tag
guids.id
labels.id
labels.tag
moods.id
moods.tag
Media Info Fields
Media Info Field Level 0 Level 1 Level 2 Level 3 Level 9
locations
media.audioChannels
media.audioCodec
media.audioProfile
media.bitrate
media.container
media.duration
media.id
media.title
media.parts.accessible
media.parts.audioProfile
media.parts.container
media.parts.deepAnalysisVersion
media.parts.duration
media.parts.exists
media.parts.file
media.parts.hasThumbnail
media.parts.id
media.parts.key
media.parts.requiredBandwidths
media.parts.size
media.parts.sizeHuman
media.parts.syncItemId
media.parts.syncState
media.parts.audioStreams.albumGain
media.parts.audioStreams.albumPeak
media.parts.audioStreams.albumRange
media.parts.audioStreams.audioChannelLayout
media.parts.audioStreams.bitDepth
media.parts.audioStreams.bitrate
media.parts.audioStreams.bitrateMode
media.parts.audioStreams.channels
media.parts.audioStreams.codec
media.parts.audioStreams.default
media.parts.audioStreams.displayTitle
media.parts.audioStreams.duration
media.parts.audioStreams.endRamp
media.parts.audioStreams.extendedDisplayTitle
media.parts.audioStreams.gain
media.parts.audioStreams.id
media.parts.audioStreams.index
media.parts.audioStreams.key
media.parts.audioStreams.language
media.parts.audioStreams.languageCode
media.parts.audioStreams.languageTag
media.parts.audioStreams.loudness
media.parts.audioStreams.lra
media.parts.audioStreams.peak
media.parts.audioStreams.profile
media.parts.audioStreams.requiredBandwidths
media.parts.audioStreams.samplingRate
media.parts.audioStreams.selected
media.parts.audioStreams.startRamp
media.parts.audioStreams.streamType
media.parts.audioStreams.title
media.parts.audioStreams.type
media.parts.lyricStreams.codec
media.parts.lyricStreams.default
media.parts.lyricStreams.displayTitle
media.parts.lyricStreams.extendedDisplayTitle
media.parts.lyricStreams.format
media.parts.lyricStreams.id
media.parts.lyricStreams.index
media.parts.lyricStreams.key
media.parts.lyricStreams.language
media.parts.lyricStreams.languageCode
media.parts.lyricStreams.languageTag
media.parts.lyricStreams.minLines
media.parts.lyricStreams.provider
media.parts.lyricStreams.requiredBandwidths
media.parts.lyricStreams.selected
media.parts.lyricStreams.streamType
media.parts.lyricStreams.timed
media.parts.lyricStreams.title
media.parts.lyricStreams.type

Photo Albums

Metadata Fields
Metadata Field Level 0 Level 1 Level 2 Level 3 Level 9
addedAt
art
composite
guid
index
key
lastRatedAt
librarySectionID
librarySectionKey
librarySectionTitle
metadataDirectory
ratingKey
summary
thumb
title
titleSort
type
updatedAt
userRating
fields.locked
fields.name
photoalbums
Includes Photo Albums Level 1

Includes Photo Albums Level 2

Includes Photo Albums Level 3

Includes Photo Albums Level 9
photos
Includes Photos Level 1

Includes Photos Level 2

Includes Photos Level 3

Includes Photos Level 9
clips
Includes Clips Level 1

Includes Clips Level 2

Includes Clips Level 3

Includes Clips Level 9
Media Info Fields
Media Info Field Level 0 Level 1 Level 2 Level 3 Level 9
photoalbums
Includes Photo Albums Level 1

Includes Photo Albums Level 2

Includes Photo Albums Level 3

Includes Photo Albums Level 9
photos
Includes Photos Level 1

Includes Photos Level 2

Includes Photos Level 3

Includes Photos Level 9
clips
Includes Clips Level 1

Includes Clips Level 2

Includes Clips Level 3

Includes Clips Level 9

Photos

Metadata Fields
Metadata Field Level 0 Level 1 Level 2 Level 3 Level 9
addedAt
createdAtAccuracy
createdAtTZOffset
guid
index
key
lastRatedAt
librarySectionID
librarySectionKey
librarySectionTitle
metadataDirectory
originallyAvailableAt
parentGuid
parentIndex
parentKey
parentRatingKey
parentThumb
parentTitle
ratingKey
summary
thumb
title
titleSort
type
updatedAt
userRating
year
fields.locked
fields.name
tag.id
tag.tag
tag.title
Media Info Fields
Media Info Field Level 0 Level 1 Level 2 Level 3 Level 9
locations
media.aperture
media.aspectRatio
media.container
media.exposure
media.height
media.id
media.iso
media.lens
media.make
media.model
media.width
media.parts.accessible
media.parts.container
media.parts.exists
media.parts.file
media.parts.id
media.parts.key
media.parts.size
media.parts.sizeHuman

Clips

Metadata Fields
Metadata Field Level 0 Level 1 Level 2 Level 3 Level 9
addedAt
art
artBlurHash
artFile
artProvider
audienceRating
audienceRatingImage
chapterSource
contentRating
duration
durationHuman
episodeNumber
grandparentArt
grandparentGuid
grandparentKey
grandparentRatingKey
grandparentTheme
grandparentThumb
grandparentTitle
guid
hasCommercialMarker
hasCreditsMarker
hasIntroMarker
hasPreviewThumbnails
hasVoiceActivity
index
key
lastRatedAt
lastViewedAt
librarySectionID
librarySectionKey
librarySectionTitle
metadataDirectory
originallyAvailableAt
parentGuid
parentIndex
parentKey
parentRatingKey
parentThumb
parentTitle
parentYear
rating
ratingKey
seasonEpisode
seasonNumber
slug
summary
thumb
thumbBlurHash
thumbFile
thumbProvider
title
titleSort
type
updatedAt
userRating
viewCount
viewOffset
year
chapters.end
chapters.id
chapters.index
chapters.start
chapters.tag
chapters.thumb
collections.id
collections.tag
directors.id
directors.tag
fields.locked
fields.name
guids.id
labels.id
labels.tag
markers.end
markers.final
markers.first
markers.id
markers.start
markers.type
producers.id
producers.tag
roles.id
roles.role
roles.tag
roles.thumb
writers.id
writers.tag
Media Info Fields
Media Info Field Level 0 Level 1 Level 2 Level 3 Level 9
locations
media.aspectRatio
media.audioChannels
media.audioCodec
media.audioProfile
media.bitrate
media.container
media.duration
media.has64bitOffsets
media.hasVoiceActivity
media.hdr
media.height
media.id
media.isOptimizedVersion
media.optimizedForStreaming
media.proxyType
media.target
media.title
media.videoCodec
media.videoFrameRate
media.videoProfile
media.videoResolution
media.width
media.parts.accessible
media.parts.audioProfile
media.parts.container
media.parts.deepAnalysisVersion
media.parts.duration
media.parts.exists
media.parts.file
media.parts.has64bitOffsets
media.parts.hasPreviewThumbnails
media.parts.hasThumbnail
media.parts.id
media.parts.indexes
media.parts.key
media.parts.optimizedForStreaming
media.parts.packetLength
media.parts.requiredBandwidths
media.parts.size
media.parts.sizeHuman
media.parts.syncItemId
media.parts.syncState
media.parts.videoProfile
media.parts.audioStreams.audioChannelLayout
media.parts.audioStreams.bitDepth
media.parts.audioStreams.bitrate
media.parts.audioStreams.bitrateMode
media.parts.audioStreams.channels
media.parts.audioStreams.codec
media.parts.audioStreams.default
media.parts.audioStreams.displayTitle
media.parts.audioStreams.duration
media.parts.audioStreams.extendedDisplayTitle
media.parts.audioStreams.id
media.parts.audioStreams.index
media.parts.audioStreams.key
media.parts.audioStreams.language
media.parts.audioStreams.languageCode
media.parts.audioStreams.languageTag
media.parts.audioStreams.profile
media.parts.audioStreams.requiredBandwidths
media.parts.audioStreams.samplingRate
media.parts.audioStreams.selected
media.parts.audioStreams.streamIdentifier
media.parts.audioStreams.streamType
media.parts.audioStreams.title
media.parts.audioStreams.type
media.parts.subtitleStreams.canAutoSync
media.parts.subtitleStreams.codec
media.parts.subtitleStreams.container
media.parts.subtitleStreams.default
media.parts.subtitleStreams.displayTitle
media.parts.subtitleStreams.extendedDisplayTitle
media.parts.subtitleStreams.forced
media.parts.subtitleStreams.format
media.parts.subtitleStreams.headerCompression
media.parts.subtitleStreams.id
media.parts.subtitleStreams.index
media.parts.subtitleStreams.key
media.parts.subtitleStreams.language
media.parts.subtitleStreams.languageCode
media.parts.subtitleStreams.languageTag
media.parts.subtitleStreams.providerTitle
media.parts.subtitleStreams.requiredBandwidths
media.parts.subtitleStreams.score
media.parts.subtitleStreams.selected
media.parts.subtitleStreams.sourceKey
media.parts.subtitleStreams.streamType
media.parts.subtitleStreams.title
media.parts.subtitleStreams.transient
media.parts.subtitleStreams.type
media.parts.subtitleStreams.userID
media.parts.videoStreams.DOVIBLCompatID
media.parts.videoStreams.DOVIBLPresent
media.parts.videoStreams.DOVIELPresent
media.parts.videoStreams.DOVILevel
media.parts.videoStreams.DOVIPresent
media.parts.videoStreams.DOVIProfile
media.parts.videoStreams.DOVIRPUPresent
media.parts.videoStreams.DOVIVersion
media.parts.videoStreams.anamorphic
media.parts.videoStreams.bitDepth
media.parts.videoStreams.bitrate
media.parts.videoStreams.cabac
media.parts.videoStreams.chromaLocation
media.parts.videoStreams.chromaSubsampling
media.parts.videoStreams.codec
media.parts.videoStreams.codecID
media.parts.videoStreams.codedHeight
media.parts.videoStreams.codedWidth
media.parts.videoStreams.colorPrimaries
media.parts.videoStreams.colorRange
media.parts.videoStreams.colorSpace
media.parts.videoStreams.colorTrc
media.parts.videoStreams.default
media.parts.videoStreams.displayTitle
media.parts.videoStreams.duration
media.parts.videoStreams.extendedDisplayTitle
media.parts.videoStreams.frameRate
media.parts.videoStreams.frameRateMode
media.parts.videoStreams.hasScalingMatrix
media.parts.videoStreams.hdr
media.parts.videoStreams.height
media.parts.videoStreams.id
media.parts.videoStreams.index
media.parts.videoStreams.key
media.parts.videoStreams.language
media.parts.videoStreams.languageCode
media.parts.videoStreams.languageTag
media.parts.videoStreams.level
media.parts.videoStreams.pixelAspectRatio
media.parts.videoStreams.pixelFormat
media.parts.videoStreams.profile
media.parts.videoStreams.refFrames
media.parts.videoStreams.requiredBandwidths
media.parts.videoStreams.scanType
media.parts.videoStreams.selected
media.parts.videoStreams.streamIdentifier
media.parts.videoStreams.streamType
media.parts.videoStreams.title
media.parts.videoStreams.type
media.parts.videoStreams.width

Collections

Metadata Fields
Metadata Field Level 0 Level 1 Level 2 Level 3 Level 9
addedAt
art
artBlurHash
artFile Refer to Image Exports
artProvider
childCount
collectionFilterBasedOnUser
collectionMode
collectionSort
contentRating
guid
index
key
lastRatedAt
librarySectionID
librarySectionKey
librarySectionTitle
maxYear
metadataDirectory
minYear
ratingKey
subtype
summary
theme
thumb
thumbBlurHash
thumbFile Refer to Image Exports
thumbProvider
title
titleSort
type
updatedAt
userRating
fields.locked
fields.name
labels.id
labels.tag
items
Includes Items Level 1

Includes Items Level 2

Includes Items Level 3

Includes Items Level 9
Media Info Fields
Media Info Field Level 0 Level 1 Level 2 Level 3 Level 9
items
Includes Items Level 1

Includes Items Level 2

Includes Items Level 3

Includes Items Level 9

Playlists

Metadata Fields
Metadata Field Level 0 Level 1 Level 2 Level 3 Level 9
addedAt
composite
content
duration
durationHuman
guid
icon
key
leafCount
metadataDirectory
playlistType
ratingKey
smart
sourceURI
summary
title
type
updatedAt
items
Includes Items Level 1

Includes Items Level 2

Includes Items Level 3

Includes Items Level 9
Media Info Fields
Media Info Field Level 0 Level 1 Level 2 Level 3 Level 9
items
Includes Items Level 1

Includes Items Level 2

Includes Items Level 3

Includes Items Level 9