+ 
+
+ 
+
+
+
+ 
+
+
+1. Set a "Script Folder" and a "Script File"
+
+ 
+
+1. Select the triggers that will be used to run the script. (e.g. Playback Start, Playback Stop).
+
+ 
+
+1. If you want to limit when the script runs, add [[custom conditions|Custom Notification Conditions]] to the agent.
+
+ 
+
+1. Set the arguments that should be passed to the script
+
+ 
+
+1. Save. Voila, all done!
+
+## Environment Variables
+
+| Variable | Description |
+| --- | --- |
+| `PLEX_URL` | The URL used to connect to the Plex server (e.g. `http://127.0.0.1:32400`). |
+| `PLEX_TOKEN` | The admin's Plex token. |
+| `PLEX_USER_TOKEN` | The user's Plex token only available for notifications with a user context (i.e. Playback triggers). |
+| `TAUTULLI_URL` | The URL used to connect to the Tautulli server (e.g. `http://127.0.0.1:8181`). |
+| `TAUTULLI_PUBLIC_URL` | The Public Tautulli Domain only if set in the Tautulli settings. |
+| `TAUTULLI_APIKEY` | The Tautulli API key. |
+
+
+## List of User Created Scripts
+
+### Visit the [JBOPS GitHub Repository](https://github.com/blacktwin/JBOPS) for more up-to-date scripts created by @Blacktwin.
+
+
+#### Tautulli Scripts:
+
+| Description | Language | Author |
+| --- | --- | --- |
+| [Kill streams](https://github.com/blacktwin/JBOPS/blob/master/killstream/) | Python | [blacktwin](https://github.com/blacktwin) |
+| [Throttle nzb client](https://gist.github.com/Hellowlol/a5d0cab4bde185b38404) | Python | [Hellowlol](https://gist.github.com/Hellowlol) |
+| [Send an Email notification to users when a new episode to their "favorite" show have been added to Plex](https://github.com/blacktwin/JBOPS/blob/master/notify/notify_user_favorites.py) | Python | [blacktwin](https://gist.github.com/blacktwin) |
+| [Send a Tautulli notification with the movie directors' IMDB page](https://gist.github.com/JonnyWong16/d508d8d5d1fcb336efc1a3d167eb7b1a) | Python | [JonnyWong16](https://gist.github.com/JonnyWong16) |
+| [Send a random Chuck Norris joke when a movie starring Chuck Norris is played](https://gist.github.com/JonnyWong16/6e3b07bbc99eeb15183ba86be5bdf9a7) | Python | [JonnyWong16](https://gist.github.com/JonnyWong16) |
+| [Send a Tautulli notification with geolocation data](https://gist.github.com/JonnyWong16/48d6362884b5edbf5e6d78859035183a) | Python | [JonnyWong16](https://gist.github.com/JonnyWong16) |
+| [Get notified when Plex disk usage exceeds a certain threshold](https://gist.github.com/JonnyWong16/f561f06a6266db66dad9) | Python | [JonnyWong16](https://gist.github.com/JonnyWong16) |
+| [Delete Tautulli history older than "X" days](https://gist.github.com/JonnyWong16/cb1b53e71b89d2159313) | Python | [JonnyWong16](https://gist.github.com/JonnyWong16) |
+| [Restart Plex](https://gist.github.com/Hellowlol/daaa7aa4c5f8bd54033895df5a5fb2d2) | bat | [Hellowlol](https://gist.github.com/Hellowlol) |
+| [Plex Docker Container Restart with Rancher](https://gist.github.com/JigSawFr/70d7f95f16f1f6f27528a18e183ee67c) | Bash | [JigSawFr](https://gist.github.com/JigSawFr) |
+| [Tautulli - Quiet hours and smart batching for Pushbullet notifications](https://gist.github.com/JimboMonkey1234/1c27897c3204c6b72a05fea64f0a9f02) | Python | [JimboMonkey1234](https://gist.github.com/JimboMonkey1234) |
+| [Generate map from user geolocation data](https://github.com/blacktwin/JBOPS/tree/master/maps) | Python | [blacktwin](https://gist.github.com/blacktwin) |
+| [Get notified when new IP address accesses Plex](https://github.com/blacktwin/JBOPS/blob/master/notify/notify_newip.py) | Python | [blacktwin](https://gist.github.com/blacktwin) |
+| [Run a SSH command using Python](https://gist.github.com/JonnyWong16/e140f546b09950829685f000b7cf98bc) | Python | [JonnyWong16](https://gist.github.com/JonnyWong16) |
+| [Automatically add a label to recently added items](https://gist.github.com/JonnyWong16/4cfcf8ea50dab1b720b4d30e9a01835c) | Python | [JonnyWong16](https://gist.github.com/JonnyWong16) |
+| [Automatically mark a multi-episode file as watched in Plex](https://gist.github.com/JonnyWong16/7708c5e755c74e169c115490b0749279) | Python | [JonnyWong16](https://gist.github.com/JonnyWong16) |
+| [Automatically change episode artwork in Plex to hide spoilers](https://gist.github.com/JonnyWong16/ea8f51f674fdb4ebf4e47e53cd1a10e5) | Python | [JonnyWong16](https://gist.github.com/JonnyWong16) |
+| [Updates all metadata in the Tautulli database after moving Plex libraries](https://gist.github.com/JonnyWong16/f554f407832076919dc6864a78432db2) | Python | [JonnyWong16](https://gist.github.com/JonnyWong16) |
+| [Send recently added through native iOS push (OneSignal)](https://gist.github.com/LuisNunezC/64a3e677887c8ffb76e0f0de1c43311b) | Python | [LuisNunezC](https://github.com/LuisNunezC) |
+| [Notify Sonarr that a plexDVR recording has been added to the library](https://gist.github.com/metaMMA/4ecd6579476fce7e93b6c8a5271c12ae) | Bash | [metaMMA](https://github.com/metaMMA) |
+| [Notification script for Facebook Groups](https://gist.github.com/spuniun/56624e1464c621c91e52f88e03321582) | Python | [spuniun](https://github.com/spuniun) |
+
+
+#### Other Plex Scripts:
+
+| Description | Language | Author |
+| --- | --- | --- |
+| [Automatically share and unshare libraries for Plex users](https://gist.github.com/JonnyWong16/f8139216e2748cb367558070c1448636) | Python | [JonnyWong16](https://gist.github.com/JonnyWong16) |
+| [Execute a command when no Plex sessions are active](https://gist.github.com/JonnyWong16/bc50c882985cc495e629f41c12bc7590) | Python | [JonnyWong16](https://gist.github.com/JonnyWong16) |
+| [Create a Plex collection from a text file list of rating keys](https://gist.github.com/JonnyWong16/148b5a5dc39211bd6a871cb8f9df8c48) | Python | [JonnyWong16](https://gist.github.com/JonnyWong16) |
+| [Sync Plex playlists to shared users](https://gist.github.com/JonnyWong16/2607abf0e3431b6f133861bbe1bb694e) | Python | [JonnyWong16](https://gist.github.com/JonnyWong16) |
+| [Removes ALL collections from ALL movies](https://gist.github.com/JonnyWong16/34878448ab45dfffffa930f5cf8c252a) | Python | [JonnyWong16](https://gist.github.com/JonnyWong16) |
+| [Saves artist.jpg to the Artist folder.](https://gist.github.com/JonnyWong16/8ede4aabce105217a70cc2386ce673f7) | Python | [JonnyWong16](https://gist.github.com/JonnyWong16) |
+| [Randomly create haiku based on Plex libraries content.](https://github.com/blacktwin/JBOPS/blob/master/fun/plexapi_haiku.py) | Python | [Blacktwin](https://gist.github.com/Blacktwin) |
+| [Create a Plex Playlist with what was aired today in history.](https://github.com/blacktwin/JBOPS/blob/master/fun/aired_today_playlist.py) | Python | [Blacktwin](https://gist.github.com/Blacktwin) |
+| [Pull Movie and TV Show poster images from Plex.](https://github.com/blacktwin/JBOPS/blob/master/utility/plex_api_poster_pull.py) | Python | [Blacktwin](https://gist.github.com/Blacktwin) |
+| [Download theme songs from Plex TV Shows.](https://github.com/blacktwin/JBOPS/blob/master/utility/plex_theme_songs.py) | Python | [Blacktwin](https://gist.github.com/Blacktwin) |
+| [Delete shows that a list of users have watched.](https://github.com/blacktwin/JBOPS/blob/master/utility/delete_watched_TV.py) | Python | [Blacktwin](https://gist.github.com/Blacktwin) |
+| [Delete movies that a list of users have watched.](https://github.com/blacktwin/JBOPS/blob/master/utility/remove_watched_movies.py) | Python | [Blacktwin](https://gist.github.com/Blacktwin) |
\ No newline at end of file
diff --git a/docs/Debugging.md b/docs/Debugging.md
new file mode 100644
index 00000000..8c8d1a12
--- /dev/null
+++ b/docs/Debugging.md
@@ -0,0 +1,56 @@
+# Debugging Tautulli
+
+This page guides you through some common debugging steps to verify the
+information in Tautulli.
+
+## Activity
+
+_Triple_ clicking on the word `ACTIVITY` at the top of the Tautulli page will
+open up the raw XML file on your Plex server that Tautulli is parsing in order
+to show you the current activity on the server.
+
+
+
+If you are accessing Tautulli from outside your network and the address that
+Tautulli uses to connect to Plex isn't available you will need to fix the
+location in the address bar. If you find yourself using this XML shortcut often
+you can have Tautulli automatically override the link for you by shutting down
+Tautulli, editing `config.ini`, and editing the `pms_url_override` value to the
+public location of your Plex server.
+
+_Note:_ Your browser will likely block this at first since it is a pop-up!
+You'll need to allow pop-ups in your browser for your Tautulli domain,
+instructions for the Chrome browser can be found
+[here](https://support.google.com/chrome/answer/95472?co=GENIE.Platform%3DDesktop&hl=en).
+
+## Stream Info
+
+You can view the information that Tautulli has parsed from the raw XML data for
+a particular stream by _single_ clicking on the `STREAM` word in an activity
+card:
+
+
+
+This information can be handy to check against when using text parameters or
+conditions in a Notification Agent.
+
+## More XML Shortcuts
+
+Similar to triple clicking on the word `ACTIVITY` on the home page, if you _triple_
+click on one of the following you will be brought to the XML that the data is
+being generated from:
+
+* "All Libraries" on the Libraries page
+* "All Users" on the Users page
+* "Synced Items" on the Synced Items page
+* "PLEX MEDIA SERVER" under Settings -> Plex Media Server
+* The [last breadcrumb](https://i.imgur.com/rkxFUxm.png) on any media info page
+* "RECENTLY ADDED" on the home page
+
+## Scheduled Tasks
+
+Under Settings -> Help & Info Tautulli shows you a listing of the scheduled tasks currently active on your system. You can click on the following tasks to get a pop-up with a detailed listing of their relevant information:
+* _Check for active sessions_
+ * Click for a listing of currently active sessions and when they will be flushed to the database if Plex fails to send a stop event for them
+* _Check for recently added items_
+ * Click for a listing of items that Tautulli has recently seen get added to Plex, and when they are scheduled to be announced
\ No newline at end of file
diff --git a/docs/Exporter-Guide.md b/docs/Exporter-Guide.md
new file mode 100644
index 00000000..e0ba6a2d
--- /dev/null
+++ b/docs/Exporter-Guide.md
@@ -0,0 +1,1345 @@
+### Contents:
+
+* [Introduction](#introduction)
+* [File Formats](#file-format)
+ * [Export Individual Files](#individual-files)
+* [Metadata and Media Info Exports](#metadata-media-info-export)
+ * [Metadata and Media Info Export Levels](#metadata-media-info-export-level)
+ * [Custom Fields](#custom-field)
+* [Image Exports](#image-export)
+ * [Image Export Levels](#image-export-level)
+* [Media Type Fields](#media-type-field)
+ * [Movies](#movie)
+ * [Shows](#show)
+ * [Seasons](#season)
+ * [Episodes](#episode)
+ * [Artists](#artist)
+ * [Albums](#album)
+ * [Tracks](#track)
+ * [Photo Albums](#photoalbum)
+ * [Photos](#photo)
+ * [Clips](#clip)
+ * [Collections](#collection)
+ * [Playlists](#playlist)
+
+---
+
+## 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](./images/exporter_library_collections.png), [Playlists](./images/exporter_library_playlists.png), or [Export](./images/exporter_library_export.png) tabs. This will allow you to export all of your collections, playlists or all items for any library on your Plex server.
+1. On any user page from the [Playlists](./images/exporter_user_playlists.png) tab. This will allow you to export all of a user's playlists for any user on your Plex server.
+1. On any media info page from the [Export](./images/exporter_media_info.png) 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](./images/exporter_modal.png) where you can customize your export. All the customization options are described in the sections below.
+
+The [metadata exports table](./images/exporter_table.png) 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).
- **Note:** The `xml` export is not the same as the [Plex XML data](https://support.plex.tv/articles/201998867-investigate-media-information-and-formats/).
- **Note:** All files will be added to the playlist if there are multiple parts/versions.
- **Note:** Export level selections are not allowed.
`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](./images/exporter_custom_fields.png) 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](#media-type-field) 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](#collection) and [Playlists](#playlist), the `items` prefix can be different media types depending on the context. Refer to the [Media Type Fields](#media-type-field) 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](./images/exporter_images.png) 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 and `.art.jpg` for background artwork. When downloading an export from the [metadata exports table](./images/exporter_table.png), 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 and `artFile` for background artwork 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. | + + +## Media Type Fields + + +### Movies + +
+
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `art` | | | | ✓ | ✓ | +| `artBlurHash` | | | | | ✓ | +| `artFile` | Refer to [Image Exports](#image-export) | | | | | +| `audienceRating` | | ✓ | ✓ | ✓ | ✓ | +| `audienceRatingImage` | | ✓ | ✓ | ✓ | ✓ | +| `chapterSource` | | | | ✓ | ✓ | +| `contentRating` | | ✓ | ✓ | ✓ | ✓ | +| `duration` | | ✓ | ✓ | ✓ | ✓ | +| `durationHuman` | | ✓ | ✓ | ✓ | ✓ | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `key` | | | | ✓ | ✓ | +| `languageOverride` | | | | | ✓ | +| `lastViewedAt` | | | | ✓ | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `originalTitle` | | ✓ | ✓ | ✓ | ✓ | +| `originallyAvailableAt` | | ✓ | ✓ | ✓ | ✓ | +| `rating` | | ✓ | ✓ | ✓ | ✓ | +| `ratingImage` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `studio` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `tagline` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `thumbBlurHash` | | | | | ✓ | +| `thumbFile` | Refer to [Image Exports](#image-export) | | | | | +| `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` | | | ✓ | ✓ | ✓ | +| `producers.id` | | | | | ✓ | +| `producers.tag` | | | ✓ | ✓ | ✓ | +| `roles.id` | | | | | ✓ | +| `roles.role` | | | ✓ | ✓ | ✓ | +| `roles.tag` | | | ✓ | ✓ | ✓ | +| `roles.thumb` | | | | | ✓ | +| `writers.id` | | | | | ✓ | +| `writers.tag` | | | ✓ | ✓ | ✓ | +
+
+Metadata Fields
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `art` | | | | ✓ | ✓ | +| `artBlurHash` | | | | | ✓ | +| `artFile` | Refer to [Image Exports](#image-export) | | | | | +| `audienceRating` | | ✓ | ✓ | ✓ | ✓ | +| `audienceRatingImage` | | ✓ | ✓ | ✓ | ✓ | +| `chapterSource` | | | | ✓ | ✓ | +| `contentRating` | | ✓ | ✓ | ✓ | ✓ | +| `duration` | | ✓ | ✓ | ✓ | ✓ | +| `durationHuman` | | ✓ | ✓ | ✓ | ✓ | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `key` | | | | ✓ | ✓ | +| `languageOverride` | | | | | ✓ | +| `lastViewedAt` | | | | ✓ | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `originalTitle` | | ✓ | ✓ | ✓ | ✓ | +| `originallyAvailableAt` | | ✓ | ✓ | ✓ | ✓ | +| `rating` | | ✓ | ✓ | ✓ | ✓ | +| `ratingImage` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `studio` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `tagline` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `thumbBlurHash` | | | | | ✓ | +| `thumbFile` | Refer to [Image Exports](#image-export) | | | | | +| `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` | | | ✓ | ✓ | ✓ | +| `producers.id` | | | | | ✓ | +| `producers.tag` | | | ✓ | ✓ | ✓ | +| `roles.id` | | | | | ✓ | +| `roles.role` | | | ✓ | ✓ | ✓ | +| `roles.tag` | | | ✓ | ✓ | ✓ | +| `roles.thumb` | | | | | ✓ | +| `writers.id` | | | | | ✓ | +| `writers.tag` | | | ✓ | ✓ | ✓ | +
+
+ +| 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.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.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.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.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.requiredBandwidths` | | | | | ✓ | +| `media.parts.subtitleStreams.selected` | | | | | ✓ | +| `media.parts.subtitleStreams.streamType` | | | | | ✓ | +| `media.parts.subtitleStreams.title` | | | | ✓ | ✓ | +| `media.parts.subtitleStreams.transient` | | | | | ✓ | +| `media.parts.subtitleStreams.type` | | | | | ✓ | +| `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.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
+
+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.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.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.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.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.requiredBandwidths` | | | | | ✓ | +| `media.parts.subtitleStreams.selected` | | | | | ✓ | +| `media.parts.subtitleStreams.streamType` | | | | | ✓ | +| `media.parts.subtitleStreams.title` | | | | ✓ | ✓ | +| `media.parts.subtitleStreams.transient` | | | | | ✓ | +| `media.parts.subtitleStreams.type` | | | | | ✓ | +| `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.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` | | | | ✓ | ✓ | +
+
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `art` | | | | ✓ | ✓ | +| `artBlurHash` | | | | | ✓ | +| `artFile` | Refer to [Image Exports](#image-export) | | | | | +| `audienceRating` | | ✓ | ✓ | ✓ | ✓ | +| `audienceRatingImage` | | ✓ | ✓ | ✓ | ✓ | +| `autoDeletionItemPolicyUnwatchedLibrary` | | | | | ✓ | +| `autoDeletionItemPolicyWatchedLibrary` | | | | | ✓ | +| `banner` | | | | ✓ | ✓ | +| `bannerFile` | | | | | ✓ | +| `childCount` | | ✓ | ✓ | ✓ | ✓ | +| `contentRating` | | ✓ | ✓ | ✓ | ✓ | +| `duration` | | ✓ | ✓ | ✓ | ✓ | +| `durationHuman` | | ✓ | ✓ | ✓ | ✓ | +| `episodeSort` | | | | | ✓ | +| `flattenSeasons` | | | | | ✓ | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | | | | ✓ | +| `key` | | | | ✓ | ✓ | +| `languageOverride` | | | | | ✓ | +| `lastViewedAt` | | | | ✓ | ✓ | +| `leafCount` | | | | | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `network` | | ✓ | ✓ | ✓ | ✓ | +| `originalTitle` | | ✓ | ✓ | ✓ | ✓ | +| `originallyAvailableAt` | | ✓ | ✓ | ✓ | ✓ | +| `rating` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `showOrdering` | | | | | ✓ | +| `studio` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `tagline` | | ✓ | ✓ | ✓ | ✓ | +| `theme` | | | | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `thumbBlurHash` | | | | | ✓ | +| `thumbFile` | Refer to [Image Exports](#image-export) | | | | | +| `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](#show-season) Level 1 | ✓
Includes [Seasons](#show-season) Level 2 | ✓
Includes [Seasons](#show-season) Level 3 | ✓
Includes [Seasons](#show-season) Level 9 | +
+
+Metadata Fields
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `art` | | | | ✓ | ✓ | +| `artBlurHash` | | | | | ✓ | +| `artFile` | Refer to [Image Exports](#image-export) | | | | | +| `audienceRating` | | ✓ | ✓ | ✓ | ✓ | +| `audienceRatingImage` | | ✓ | ✓ | ✓ | ✓ | +| `autoDeletionItemPolicyUnwatchedLibrary` | | | | | ✓ | +| `autoDeletionItemPolicyWatchedLibrary` | | | | | ✓ | +| `banner` | | | | ✓ | ✓ | +| `bannerFile` | | | | | ✓ | +| `childCount` | | ✓ | ✓ | ✓ | ✓ | +| `contentRating` | | ✓ | ✓ | ✓ | ✓ | +| `duration` | | ✓ | ✓ | ✓ | ✓ | +| `durationHuman` | | ✓ | ✓ | ✓ | ✓ | +| `episodeSort` | | | | | ✓ | +| `flattenSeasons` | | | | | ✓ | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | | | | ✓ | +| `key` | | | | ✓ | ✓ | +| `languageOverride` | | | | | ✓ | +| `lastViewedAt` | | | | ✓ | ✓ | +| `leafCount` | | | | | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `network` | | ✓ | ✓ | ✓ | ✓ | +| `originalTitle` | | ✓ | ✓ | ✓ | ✓ | +| `originallyAvailableAt` | | ✓ | ✓ | ✓ | ✓ | +| `rating` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `showOrdering` | | | | | ✓ | +| `studio` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `tagline` | | ✓ | ✓ | ✓ | ✓ | +| `theme` | | | | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `thumbBlurHash` | | | | | ✓ | +| `thumbFile` | Refer to [Image Exports](#image-export) | | | | | +| `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](#show-season) Level 1 | ✓
Includes [Seasons](#show-season) Level 2 | ✓
Includes [Seasons](#show-season) Level 3 | ✓
Includes [Seasons](#show-season) Level 9 | +
+
+ +| Media Info Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `locations` | | | | | ✓ | +| `seasons` | | ✓
Includes [Seasons](#show-season) Level 1 | ✓
Includes [Seasons](#show-season) Level 2 | ✓
Includes [Seasons](#show-season) Level 3 | ✓
Includes [Seasons](#show-season) Level 9 | +
+
+
+### Seasons
+
+Media Info Fields
+ +| Media Info Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `locations` | | | | | ✓ | +| `seasons` | | ✓
Includes [Seasons](#show-season) Level 1 | ✓
Includes [Seasons](#show-season) Level 2 | ✓
Includes [Seasons](#show-season) Level 3 | ✓
Includes [Seasons](#show-season) Level 9 | +
+
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `art` | | | | ✓ | ✓ | +| `artBlurHash` | | | | | ✓ | +| `artFile` | Refer to [Image Exports](#image-export) | | | | | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | ✓ | ✓ | ✓ | ✓ | +| `key` | | | | ✓ | ✓ | +| `lastViewedAt` | | | | ✓ | ✓ | +| `leafCount` | | | | | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `parentGuid` | | ✓ | ✓ | ✓ | ✓ | +| `parentIndex` | | | | | ✓ | +| `parentKey` | | | | ✓ | ✓ | +| `parentRatingKey` | | ✓ | ✓ | ✓ | ✓ | +| `parentTheme` | | | | ✓ | ✓ | +| `parentThumb` | | | | ✓ | ✓ | +| `parentTitle` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `thumbBlurHash` | | | | | ✓ | +| `thumbFile` | Refer to [Image Exports](#image-export) | | | | | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `titleSort` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `userRating` | | ✓ | ✓ | ✓ | ✓ | +| `viewCount` | | | | ✓ | ✓ | +| `viewedLeafCount` | | | | | ✓ | +| `fields.locked` | | | ✓ | ✓ | ✓ | +| `fields.name` | | | ✓ | ✓ | ✓ | +| `guids.id` | | | ✓ | ✓ | ✓ | +| `episodes` | | ✓
Includes [Episodes](#season-episode) Level 1 | ✓
Includes [Episodes](#season-episode) Level 2 | ✓
Includes [Episodes](#season-episode) Level 3 | ✓
Includes [Episodes](#season-episode) Level 9 | +
+
+Metadata Fields
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `art` | | | | ✓ | ✓ | +| `artBlurHash` | | | | | ✓ | +| `artFile` | Refer to [Image Exports](#image-export) | | | | | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | ✓ | ✓ | ✓ | ✓ | +| `key` | | | | ✓ | ✓ | +| `lastViewedAt` | | | | ✓ | ✓ | +| `leafCount` | | | | | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `parentGuid` | | ✓ | ✓ | ✓ | ✓ | +| `parentIndex` | | | | | ✓ | +| `parentKey` | | | | ✓ | ✓ | +| `parentRatingKey` | | ✓ | ✓ | ✓ | ✓ | +| `parentTheme` | | | | ✓ | ✓ | +| `parentThumb` | | | | ✓ | ✓ | +| `parentTitle` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `thumbBlurHash` | | | | | ✓ | +| `thumbFile` | Refer to [Image Exports](#image-export) | | | | | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `titleSort` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `userRating` | | ✓ | ✓ | ✓ | ✓ | +| `viewCount` | | | | ✓ | ✓ | +| `viewedLeafCount` | | | | | ✓ | +| `fields.locked` | | | ✓ | ✓ | ✓ | +| `fields.name` | | | ✓ | ✓ | ✓ | +| `guids.id` | | | ✓ | ✓ | ✓ | +| `episodes` | | ✓
Includes [Episodes](#season-episode) Level 1 | ✓
Includes [Episodes](#season-episode) Level 2 | ✓
Includes [Episodes](#season-episode) Level 3 | ✓
Includes [Episodes](#season-episode) Level 9 | +
+
+ +| Media Info Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `episodes` | | ✓
Includes [Episodes](#season-episode) Level 1 | ✓
Includes [Episodes](#season-episode) Level 2 | ✓
Includes [Episodes](#season-episode) Level 3 | ✓
Includes [Episodes](#season-episode) Level 9 | +
+
+
+### Episodes
+
+Media Info Fields
+ +| Media Info Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `episodes` | | ✓
Includes [Episodes](#season-episode) Level 1 | ✓
Includes [Episodes](#season-episode) Level 2 | ✓
Includes [Episodes](#season-episode) Level 3 | ✓
Includes [Episodes](#season-episode) Level 9 | +
+
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `art` | | | | ✓ | ✓ | +| `artBlurHash` | | | | | ✓ | +| `artFile` | | | | | ✓ | +| `audienceRating` | | ✓ | ✓ | ✓ | ✓ | +| `audienceRatingImage` | | ✓ | ✓ | ✓ | ✓ | +| `chapterSource` | | | | ✓ | ✓ | +| `contentRating` | | ✓ | ✓ | ✓ | ✓ | +| `duration` | | ✓ | ✓ | ✓ | ✓ | +| `durationHuman` | | ✓ | ✓ | ✓ | ✓ | +| `grandparentArt` | | | | ✓ | ✓ | +| `grandparentGuid` | | ✓ | ✓ | ✓ | ✓ | +| `grandparentKey` | | | | ✓ | ✓ | +| `grandparentRatingKey` | | ✓ | ✓ | ✓ | ✓ | +| `grandparentTheme` | | | | ✓ | ✓ | +| `grandparentThumb` | | | | ✓ | ✓ | +| `grandparentTitle` | | ✓ | ✓ | ✓ | ✓ | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `hasIntroMarker` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | ✓ | ✓ | ✓ | ✓ | +| `key` | | | | ✓ | ✓ | +| `lastViewedAt` | | | | ✓ | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `originallyAvailableAt` | | ✓ | ✓ | ✓ | ✓ | +| `parentGuid` | | ✓ | ✓ | ✓ | ✓ | +| `parentIndex` | | ✓ | ✓ | ✓ | ✓ | +| `parentKey` | | | | ✓ | ✓ | +| `parentRatingKey` | | ✓ | ✓ | ✓ | ✓ | +| `parentThumb` | | | | ✓ | ✓ | +| `parentTitle` | | ✓ | ✓ | ✓ | ✓ | +| `rating` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `thumbBlurHash` | | | | | ✓ | +| `thumbFile` | | | | | ✓ | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `titleSort` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `userRating` | | ✓ | ✓ | ✓ | ✓ | +| `viewCount` | | | | ✓ | ✓ | +| `viewOffset` | | | | | ✓ | +| `year` | | ✓ | ✓ | ✓ | ✓ | +| `chapters.end` | | | | ✓ | ✓ | +| `chapters.id` | | | | | ✓ | +| `chapters.index` | | | | ✓ | ✓ | +| `chapters.start` | | | | ✓ | ✓ | +| `chapters.tag` | | | | ✓ | ✓ | +| `chapters.thumb` | | | | ✓ | ✓ | +| `directors.id` | | | | | ✓ | +| `directors.tag` | | | ✓ | ✓ | ✓ | +| `fields.locked` | | | ✓ | ✓ | ✓ | +| `fields.name` | | | ✓ | ✓ | ✓ | +| `guids.id` | | | ✓ | ✓ | ✓ | +| `markers.end` | | | ✓ | ✓ | ✓ | +| `markers.start` | | | ✓ | ✓ | ✓ | +| `markers.type` | | | ✓ | ✓ | ✓ | +| `writers.id` | | | | | ✓ | +| `writers.tag` | | | ✓ | ✓ | ✓ | +
+
+Metadata Fields
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `art` | | | | ✓ | ✓ | +| `artBlurHash` | | | | | ✓ | +| `artFile` | | | | | ✓ | +| `audienceRating` | | ✓ | ✓ | ✓ | ✓ | +| `audienceRatingImage` | | ✓ | ✓ | ✓ | ✓ | +| `chapterSource` | | | | ✓ | ✓ | +| `contentRating` | | ✓ | ✓ | ✓ | ✓ | +| `duration` | | ✓ | ✓ | ✓ | ✓ | +| `durationHuman` | | ✓ | ✓ | ✓ | ✓ | +| `grandparentArt` | | | | ✓ | ✓ | +| `grandparentGuid` | | ✓ | ✓ | ✓ | ✓ | +| `grandparentKey` | | | | ✓ | ✓ | +| `grandparentRatingKey` | | ✓ | ✓ | ✓ | ✓ | +| `grandparentTheme` | | | | ✓ | ✓ | +| `grandparentThumb` | | | | ✓ | ✓ | +| `grandparentTitle` | | ✓ | ✓ | ✓ | ✓ | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `hasIntroMarker` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | ✓ | ✓ | ✓ | ✓ | +| `key` | | | | ✓ | ✓ | +| `lastViewedAt` | | | | ✓ | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `originallyAvailableAt` | | ✓ | ✓ | ✓ | ✓ | +| `parentGuid` | | ✓ | ✓ | ✓ | ✓ | +| `parentIndex` | | ✓ | ✓ | ✓ | ✓ | +| `parentKey` | | | | ✓ | ✓ | +| `parentRatingKey` | | ✓ | ✓ | ✓ | ✓ | +| `parentThumb` | | | | ✓ | ✓ | +| `parentTitle` | | ✓ | ✓ | ✓ | ✓ | +| `rating` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `thumbBlurHash` | | | | | ✓ | +| `thumbFile` | | | | | ✓ | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `titleSort` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `userRating` | | ✓ | ✓ | ✓ | ✓ | +| `viewCount` | | | | ✓ | ✓ | +| `viewOffset` | | | | | ✓ | +| `year` | | ✓ | ✓ | ✓ | ✓ | +| `chapters.end` | | | | ✓ | ✓ | +| `chapters.id` | | | | | ✓ | +| `chapters.index` | | | | ✓ | ✓ | +| `chapters.start` | | | | ✓ | ✓ | +| `chapters.tag` | | | | ✓ | ✓ | +| `chapters.thumb` | | | | ✓ | ✓ | +| `directors.id` | | | | | ✓ | +| `directors.tag` | | | ✓ | ✓ | ✓ | +| `fields.locked` | | | ✓ | ✓ | ✓ | +| `fields.name` | | | ✓ | ✓ | ✓ | +| `guids.id` | | | ✓ | ✓ | ✓ | +| `markers.end` | | | ✓ | ✓ | ✓ | +| `markers.start` | | | ✓ | ✓ | ✓ | +| `markers.type` | | | ✓ | ✓ | ✓ | +| `writers.id` | | | | | ✓ | +| `writers.tag` | | | ✓ | ✓ | ✓ | +
+
+ +| 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.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.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.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.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.requiredBandwidths` | | | | | ✓ | +| `media.parts.subtitleStreams.selected` | | | | | ✓ | +| `media.parts.subtitleStreams.streamType` | | | | | ✓ | +| `media.parts.subtitleStreams.title` | | | | ✓ | ✓ | +| `media.parts.subtitleStreams.transient` | | | | | ✓ | +| `media.parts.subtitleStreams.type` | | | | | ✓ | +| `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.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
+
+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.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.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.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.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.requiredBandwidths` | | | | | ✓ | +| `media.parts.subtitleStreams.selected` | | | | | ✓ | +| `media.parts.subtitleStreams.streamType` | | | | | ✓ | +| `media.parts.subtitleStreams.title` | | | | ✓ | ✓ | +| `media.parts.subtitleStreams.transient` | | | | | ✓ | +| `media.parts.subtitleStreams.type` | | | | | ✓ | +| `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.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` | | | | ✓ | ✓ | +
+
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `albumSort` | | | | | ✓ | +| `art` | | | | ✓ | ✓ | +| `artBlurHash` | | | | | ✓ | +| `artFile` | Refer to [Image Exports](#image-export) | | | | | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | | | | ✓ | +| `key` | | | | ✓ | ✓ | +| `lastViewedAt` | | | | ✓ | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `rating` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `thumbBlurHash` | | | | | ✓ | +| `thumbFile` | Refer to [Image Exports](#image-export) | | | | | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `titleSort` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `userRating` | | ✓ | ✓ | ✓ | ✓ | +| `viewCount` | | | | ✓ | ✓ | +| `collections.id` | | | | | ✓ | +| `collections.tag` | | | ✓ | ✓ | ✓ | +| `countries.id` | | | | | ✓ | +| `countries.tag` | | | ✓ | ✓ | ✓ | +| `fields.locked` | | | ✓ | ✓ | ✓ | +| `fields.name` | | | ✓ | ✓ | ✓ | +| `genres.id` | | | | | ✓ | +| `genres.tag` | | | ✓ | ✓ | ✓ | +| `moods.id` | | | | | ✓ | +| `moods.tag` | | | ✓ | ✓ | ✓ | +| `similar.id` | | | | | ✓ | +| `similar.tag` | | | ✓ | ✓ | ✓ | +| `styles.id` | | | | | ✓ | +| `styles.tag` | | | ✓ | ✓ | ✓ | +| `albums` | | ✓
Includes [Albums](#artist-album) Level 1 | ✓
Includes [Albums](#artist-album) Level 2 | ✓
Includes [Albums](#artist-album) Level 3 | ✓
Includes [Albums](#artist-album) Level 9 | +
+
+Metadata Fields
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `albumSort` | | | | | ✓ | +| `art` | | | | ✓ | ✓ | +| `artBlurHash` | | | | | ✓ | +| `artFile` | Refer to [Image Exports](#image-export) | | | | | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | | | | ✓ | +| `key` | | | | ✓ | ✓ | +| `lastViewedAt` | | | | ✓ | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `rating` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `thumbBlurHash` | | | | | ✓ | +| `thumbFile` | Refer to [Image Exports](#image-export) | | | | | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `titleSort` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `userRating` | | ✓ | ✓ | ✓ | ✓ | +| `viewCount` | | | | ✓ | ✓ | +| `collections.id` | | | | | ✓ | +| `collections.tag` | | | ✓ | ✓ | ✓ | +| `countries.id` | | | | | ✓ | +| `countries.tag` | | | ✓ | ✓ | ✓ | +| `fields.locked` | | | ✓ | ✓ | ✓ | +| `fields.name` | | | ✓ | ✓ | ✓ | +| `genres.id` | | | | | ✓ | +| `genres.tag` | | | ✓ | ✓ | ✓ | +| `moods.id` | | | | | ✓ | +| `moods.tag` | | | ✓ | ✓ | ✓ | +| `similar.id` | | | | | ✓ | +| `similar.tag` | | | ✓ | ✓ | ✓ | +| `styles.id` | | | | | ✓ | +| `styles.tag` | | | ✓ | ✓ | ✓ | +| `albums` | | ✓
Includes [Albums](#artist-album) Level 1 | ✓
Includes [Albums](#artist-album) Level 2 | ✓
Includes [Albums](#artist-album) Level 3 | ✓
Includes [Albums](#artist-album) Level 9 | +
+
+ +| Media Info Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `locations` | | | | | ✓ | +| `albums` | | ✓
Includes [Albums](#artist-album) Level 1 | ✓
Includes [Albums](#artist-album) Level 2 | ✓
Includes [Albums](#artist-album) Level 3 | ✓
Includes [Albums](#artist-album) Level 9 | +
+
+
+### Albums
+
+Media Info Fields
+ +| Media Info Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `locations` | | | | | ✓ | +| `albums` | | ✓
Includes [Albums](#artist-album) Level 1 | ✓
Includes [Albums](#artist-album) Level 2 | ✓
Includes [Albums](#artist-album) Level 3 | ✓
Includes [Albums](#artist-album) Level 9 | +
+
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `art` | | | | ✓ | ✓ | +| `artBlurHash` | | | | | ✓ | +| `artFile` | Refer to [Image Exports](#image-export) | | | | | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | ✓ | ✓ | ✓ | ✓ | +| `key` | | | | ✓ | ✓ | +| `lastViewedAt` | | | | ✓ | ✓ | +| `leafCount` | | | | | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `loudnessAnalysisVersion` | | | | | ✓ | +| `originallyAvailableAt` | | ✓ | ✓ | ✓ | ✓ | +| `parentGuid` | | ✓ | ✓ | ✓ | ✓ | +| `parentKey` | | | | ✓ | ✓ | +| `parentRatingKey` | | ✓ | ✓ | ✓ | ✓ | +| `parentThumb` | | | | ✓ | ✓ | +| `parentTitle` | | ✓ | ✓ | ✓ | ✓ | +| `rating` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `studio` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `thumbBlurHash` | | | | | ✓ | +| `thumbFile` | Refer to [Image Exports](#image-export) | | | | | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `titleSort` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `userRating` | | ✓ | ✓ | ✓ | ✓ | +| `viewCount` | | | | ✓ | ✓ | +| `viewedLeafCount` | | | | | ✓ | +| `year` | | ✓ | ✓ | ✓ | ✓ | +| `collections.id` | | | | | ✓ | +| `collections.tag` | | | ✓ | ✓ | ✓ | +| `fields.locked` | | | ✓ | ✓ | ✓ | +| `fields.name` | | | ✓ | ✓ | ✓ | +| `genres.id` | | | | | ✓ | +| `genres.tag` | | | ✓ | ✓ | ✓ | +| `labels.id` | | | | | ✓ | +| `labels.tag` | | | ✓ | ✓ | ✓ | +| `moods.id` | | | | | ✓ | +| `moods.tag` | | | ✓ | ✓ | ✓ | +| `styles.id` | | | | | ✓ | +| `styles.tag` | | | ✓ | ✓ | ✓ | +| `tracks` | | ✓
Includes [Tracks](#album-track) Level 1 | ✓
Includes [Tracks](#album-track) Level 2 | ✓
Includes [Tracks](#album-track) Level 3 | ✓
Includes [Tracks](#album-track) Level 9 | +
+
+Metadata Fields
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `art` | | | | ✓ | ✓ | +| `artBlurHash` | | | | | ✓ | +| `artFile` | Refer to [Image Exports](#image-export) | | | | | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | ✓ | ✓ | ✓ | ✓ | +| `key` | | | | ✓ | ✓ | +| `lastViewedAt` | | | | ✓ | ✓ | +| `leafCount` | | | | | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `loudnessAnalysisVersion` | | | | | ✓ | +| `originallyAvailableAt` | | ✓ | ✓ | ✓ | ✓ | +| `parentGuid` | | ✓ | ✓ | ✓ | ✓ | +| `parentKey` | | | | ✓ | ✓ | +| `parentRatingKey` | | ✓ | ✓ | ✓ | ✓ | +| `parentThumb` | | | | ✓ | ✓ | +| `parentTitle` | | ✓ | ✓ | ✓ | ✓ | +| `rating` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `studio` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `thumbBlurHash` | | | | | ✓ | +| `thumbFile` | Refer to [Image Exports](#image-export) | | | | | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `titleSort` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `userRating` | | ✓ | ✓ | ✓ | ✓ | +| `viewCount` | | | | ✓ | ✓ | +| `viewedLeafCount` | | | | | ✓ | +| `year` | | ✓ | ✓ | ✓ | ✓ | +| `collections.id` | | | | | ✓ | +| `collections.tag` | | | ✓ | ✓ | ✓ | +| `fields.locked` | | | ✓ | ✓ | ✓ | +| `fields.name` | | | ✓ | ✓ | ✓ | +| `genres.id` | | | | | ✓ | +| `genres.tag` | | | ✓ | ✓ | ✓ | +| `labels.id` | | | | | ✓ | +| `labels.tag` | | | ✓ | ✓ | ✓ | +| `moods.id` | | | | | ✓ | +| `moods.tag` | | | ✓ | ✓ | ✓ | +| `styles.id` | | | | | ✓ | +| `styles.tag` | | | ✓ | ✓ | ✓ | +| `tracks` | | ✓
Includes [Tracks](#album-track) Level 1 | ✓
Includes [Tracks](#album-track) Level 2 | ✓
Includes [Tracks](#album-track) Level 3 | ✓
Includes [Tracks](#album-track) Level 9 | +
+
+ +| Media Info Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `tracks` | | ✓
Includes [Tracks](#album-track) Level 1 | ✓
Includes [Tracks](#album-track) Level 2 | ✓
Includes [Tracks](#album-track) Level 3 | ✓
Includes [Tracks](#album-track) Level 9 | +
+
+
+### Tracks
+
+Media Info Fields
+ +| Media Info Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `tracks` | | ✓
Includes [Tracks](#album-track) Level 1 | ✓
Includes [Tracks](#album-track) Level 2 | ✓
Includes [Tracks](#album-track) Level 3 | ✓
Includes [Tracks](#album-track) Level 9 | +
+
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `art` | | | | ✓ | ✓ | +| `artBlurHash` | | | | | ✓ | +| `chapterSource` | | | | | ✓ | +| `duration` | | ✓ | ✓ | ✓ | ✓ | +| `durationHuman` | | ✓ | ✓ | ✓ | ✓ | +| `grandparentArt` | | | | ✓ | ✓ | +| `grandparentGuid` | | ✓ | ✓ | ✓ | ✓ | +| `grandparentKey` | | | | ✓ | ✓ | +| `grandparentRatingKey` | | ✓ | ✓ | ✓ | ✓ | +| `grandparentThumb` | | | | ✓ | ✓ | +| `grandparentTitle` | | ✓ | ✓ | ✓ | ✓ | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | ✓ | ✓ | ✓ | ✓ | +| `key` | | | | ✓ | ✓ | +| `lastViewedAt` | | | | ✓ | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `originalTitle` | | ✓ | ✓ | ✓ | ✓ | +| `parentGuid` | | ✓ | ✓ | ✓ | ✓ | +| `parentIndex` | | ✓ | ✓ | ✓ | ✓ | +| `parentKey` | | | | ✓ | ✓ | +| `parentRatingKey` | | ✓ | ✓ | ✓ | ✓ | +| `parentThumb` | | | | ✓ | ✓ | +| `parentTitle` | | ✓ | ✓ | ✓ | ✓ | +| `ratingCount` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `thumbBlurHash` | | | | | ✓ | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `titleSort` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `userRating` | | ✓ | ✓ | ✓ | ✓ | +| `viewCount` | | | | ✓ | ✓ | +| `viewOffset` | | | | | ✓ | +| `year` | | ✓ | ✓ | ✓ | ✓ | +| `fields.locked` | | | ✓ | ✓ | ✓ | +| `fields.name` | | | ✓ | ✓ | ✓ | +| `moods.id` | | | | | ✓ | +| `moods.tag` | | | ✓ | ✓ | ✓ | +
+
+Metadata Fields
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `art` | | | | ✓ | ✓ | +| `artBlurHash` | | | | | ✓ | +| `chapterSource` | | | | | ✓ | +| `duration` | | ✓ | ✓ | ✓ | ✓ | +| `durationHuman` | | ✓ | ✓ | ✓ | ✓ | +| `grandparentArt` | | | | ✓ | ✓ | +| `grandparentGuid` | | ✓ | ✓ | ✓ | ✓ | +| `grandparentKey` | | | | ✓ | ✓ | +| `grandparentRatingKey` | | ✓ | ✓ | ✓ | ✓ | +| `grandparentThumb` | | | | ✓ | ✓ | +| `grandparentTitle` | | ✓ | ✓ | ✓ | ✓ | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | ✓ | ✓ | ✓ | ✓ | +| `key` | | | | ✓ | ✓ | +| `lastViewedAt` | | | | ✓ | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `originalTitle` | | ✓ | ✓ | ✓ | ✓ | +| `parentGuid` | | ✓ | ✓ | ✓ | ✓ | +| `parentIndex` | | ✓ | ✓ | ✓ | ✓ | +| `parentKey` | | | | ✓ | ✓ | +| `parentRatingKey` | | ✓ | ✓ | ✓ | ✓ | +| `parentThumb` | | | | ✓ | ✓ | +| `parentTitle` | | ✓ | ✓ | ✓ | ✓ | +| `ratingCount` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `thumbBlurHash` | | | | | ✓ | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `titleSort` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `userRating` | | ✓ | ✓ | ✓ | ✓ | +| `viewCount` | | | | ✓ | ✓ | +| `viewOffset` | | | | | ✓ | +| `year` | | ✓ | ✓ | ✓ | ✓ | +| `fields.locked` | | | ✓ | ✓ | ✓ | +| `fields.name` | | | ✓ | ✓ | ✓ | +| `moods.id` | | | | | ✓ | +| `moods.tag` | | | ✓ | ✓ | ✓ | +
+
+ +| 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.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.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
+
+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.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.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` | | | | | ✓ | +
+
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `art` | | | | ✓ | ✓ | +| `composite` | | | | | ✓ | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | ✓ | ✓ | ✓ | ✓ | +| `key` | | | | ✓ | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `titleSort` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `userRating` | | ✓ | ✓ | ✓ | ✓ | +| `fields.locked` | | | ✓ | ✓ | ✓ | +| `fields.name` | | | ✓ | ✓ | ✓ | +| `photoalbums` | | ✓
Includes [Photo Albums](#photoalbum-photoalbum) Level 1 | ✓
Includes [Photo Albums](#photoalbum-photoalbum) Level 2 | ✓
Includes [Photo Albums](#photoalbum-photoalbum) Level 3 | ✓
Includes [Photo Albums](#photoalbum-photoalbum) Level 9 | +| `photos` | | ✓
Includes [Photos](#photoalbum-photo) Level 1 | ✓
Includes [Photos](#photoalbum-photo) Level 2 | ✓
Includes [Photos](#photoalbum-photo) Level 3 | ✓
Includes [Photos](#photoalbum-photo) Level 9 | +| `clips` | | ✓
Includes [Clips](#photoalbum-clip) Level 1 | ✓
Includes [Clips](#photoalbum-clip) Level 2 | ✓
Includes [Clips](#photoalbum-clip) Level 3 | ✓
Includes [Clips](#photoalbum-clip) Level 9 | +
+
+Metadata Fields
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `art` | | | | ✓ | ✓ | +| `composite` | | | | | ✓ | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | ✓ | ✓ | ✓ | ✓ | +| `key` | | | | ✓ | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `titleSort` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `userRating` | | ✓ | ✓ | ✓ | ✓ | +| `fields.locked` | | | ✓ | ✓ | ✓ | +| `fields.name` | | | ✓ | ✓ | ✓ | +| `photoalbums` | | ✓
Includes [Photo Albums](#photoalbum-photoalbum) Level 1 | ✓
Includes [Photo Albums](#photoalbum-photoalbum) Level 2 | ✓
Includes [Photo Albums](#photoalbum-photoalbum) Level 3 | ✓
Includes [Photo Albums](#photoalbum-photoalbum) Level 9 | +| `photos` | | ✓
Includes [Photos](#photoalbum-photo) Level 1 | ✓
Includes [Photos](#photoalbum-photo) Level 2 | ✓
Includes [Photos](#photoalbum-photo) Level 3 | ✓
Includes [Photos](#photoalbum-photo) Level 9 | +| `clips` | | ✓
Includes [Clips](#photoalbum-clip) Level 1 | ✓
Includes [Clips](#photoalbum-clip) Level 2 | ✓
Includes [Clips](#photoalbum-clip) Level 3 | ✓
Includes [Clips](#photoalbum-clip) Level 9 | +
+
+ +| Media Info Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `photoalbums` | | ✓
Includes [Photo Albums](#photoalbum-photoalbum) Level 1 | ✓
Includes [Photo Albums](#photoalbum-photoalbum) Level 2 | ✓
Includes [Photo Albums](#photoalbum-photoalbum) Level 3 | ✓
Includes [Photo Albums](#photoalbum-photoalbum) Level 9 | +| `photos` | | ✓
Includes [Photos](#photoalbum-photo) Level 1 | ✓
Includes [Photos](#photoalbum-photo) Level 2 | ✓
Includes [Photos](#photoalbum-photo) Level 3 | ✓
Includes [Photos](#photoalbum-photo) Level 9 | +| `clips` | | ✓
Includes [Clips](#photoalbum-clip) Level 1 | ✓
Includes [Clips](#photoalbum-clip) Level 2 | ✓
Includes [Clips](#photoalbum-clip) Level 3 | ✓
Includes [Clips](#photoalbum-clip) Level 9 | +
+
+
+### Photos
+
+Media Info Fields
+ +| Media Info Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `photoalbums` | | ✓
Includes [Photo Albums](#photoalbum-photoalbum) Level 1 | ✓
Includes [Photo Albums](#photoalbum-photoalbum) Level 2 | ✓
Includes [Photo Albums](#photoalbum-photoalbum) Level 3 | ✓
Includes [Photo Albums](#photoalbum-photoalbum) Level 9 | +| `photos` | | ✓
Includes [Photos](#photoalbum-photo) Level 1 | ✓
Includes [Photos](#photoalbum-photo) Level 2 | ✓
Includes [Photos](#photoalbum-photo) Level 3 | ✓
Includes [Photos](#photoalbum-photo) Level 9 | +| `clips` | | ✓
Includes [Clips](#photoalbum-clip) Level 1 | ✓
Includes [Clips](#photoalbum-clip) Level 2 | ✓
Includes [Clips](#photoalbum-clip) Level 3 | ✓
Includes [Clips](#photoalbum-clip) Level 9 | +
+
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `createdAtAccuracy` | | ✓ | ✓ | ✓ | ✓ | +| `createdAtTZOffset` | | ✓ | ✓ | ✓ | ✓ | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | ✓ | ✓ | ✓ | ✓ | +| `key` | | | | ✓ | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `originallyAvailableAt` | | ✓ | ✓ | ✓ | ✓ | +| `parentGuid` | | ✓ | ✓ | ✓ | ✓ | +| `parentIndex` | | ✓ | ✓ | ✓ | ✓ | +| `parentKey` | | | | ✓ | ✓ | +| `parentRatingKey` | | ✓ | ✓ | ✓ | ✓ | +| `parentThumb` | | | | ✓ | ✓ | +| `parentTitle` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `titleSort` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `year` | | ✓ | ✓ | ✓ | ✓ | +| `fields.locked` | | | | | ✓ | +| `fields.name` | | | | | ✓ | +| `tag.id` | | | | | ✓ | +| `tag.tag` | | | ✓ | ✓ | ✓ | +| `tag.title` | | | ✓ | ✓ | ✓ | +
+
+Metadata Fields
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `createdAtAccuracy` | | ✓ | ✓ | ✓ | ✓ | +| `createdAtTZOffset` | | ✓ | ✓ | ✓ | ✓ | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | ✓ | ✓ | ✓ | ✓ | +| `key` | | | | ✓ | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `originallyAvailableAt` | | ✓ | ✓ | ✓ | ✓ | +| `parentGuid` | | ✓ | ✓ | ✓ | ✓ | +| `parentIndex` | | ✓ | ✓ | ✓ | ✓ | +| `parentKey` | | | | ✓ | ✓ | +| `parentRatingKey` | | ✓ | ✓ | ✓ | ✓ | +| `parentThumb` | | | | ✓ | ✓ | +| `parentTitle` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `titleSort` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `year` | | ✓ | ✓ | ✓ | ✓ | +| `fields.locked` | | | | | ✓ | +| `fields.name` | | | | | ✓ | +| `tag.id` | | | | | ✓ | +| `tag.tag` | | | ✓ | ✓ | ✓ | +| `tag.title` | | | ✓ | ✓ | ✓ | +
+
+ +| 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
+
+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` | | | ✓ | ✓ | ✓ | +
+
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `art` | | | | ✓ | ✓ | +| `artBlurHash` | | | | | ✓ | +| `artFile` | | | | | ✓ | +| `audienceRating` | | ✓ | ✓ | ✓ | ✓ | +| `audienceRatingImage` | | ✓ | ✓ | ✓ | ✓ | +| `chapterSource` | | | | ✓ | ✓ | +| `contentRating` | | ✓ | ✓ | ✓ | ✓ | +| `duration` | | ✓ | ✓ | ✓ | ✓ | +| `durationHuman` | | ✓ | ✓ | ✓ | ✓ | +| `grandparentArt` | | | | ✓ | ✓ | +| `grandparentGuid` | | ✓ | ✓ | ✓ | ✓ | +| `grandparentKey` | | | | ✓ | ✓ | +| `grandparentRatingKey` | | ✓ | ✓ | ✓ | ✓ | +| `grandparentTheme` | | | | ✓ | ✓ | +| `grandparentThumb` | | | | ✓ | ✓ | +| `grandparentTitle` | | ✓ | ✓ | ✓ | ✓ | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `hasIntroMarker` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | ✓ | ✓ | ✓ | ✓ | +| `key` | | | | ✓ | ✓ | +| `lastViewedAt` | | | | ✓ | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `originallyAvailableAt` | | ✓ | ✓ | ✓ | ✓ | +| `parentGuid` | | ✓ | ✓ | ✓ | ✓ | +| `parentIndex` | | ✓ | ✓ | ✓ | ✓ | +| `parentKey` | | | | ✓ | ✓ | +| `parentRatingKey` | | ✓ | ✓ | ✓ | ✓ | +| `parentThumb` | | | | ✓ | ✓ | +| `parentTitle` | | ✓ | ✓ | ✓ | ✓ | +| `rating` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `thumbBlurHash` | | | | | ✓ | +| `thumbFile` | | | | | ✓ | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `titleSort` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `userRating` | | ✓ | ✓ | ✓ | ✓ | +| `viewCount` | | | | ✓ | ✓ | +| `viewOffset` | | | | | ✓ | +| `year` | | ✓ | ✓ | ✓ | ✓ | +| `chapters.end` | | | | ✓ | ✓ | +| `chapters.id` | | | | | ✓ | +| `chapters.index` | | | | ✓ | ✓ | +| `chapters.start` | | | | ✓ | ✓ | +| `chapters.tag` | | | | ✓ | ✓ | +| `chapters.thumb` | | | | ✓ | ✓ | +| `directors.id` | | | | | ✓ | +| `directors.tag` | | | ✓ | ✓ | ✓ | +| `fields.locked` | | | ✓ | ✓ | ✓ | +| `fields.name` | | | ✓ | ✓ | ✓ | +| `guids.id` | | | ✓ | ✓ | ✓ | +| `markers.end` | | | ✓ | ✓ | ✓ | +| `markers.start` | | | ✓ | ✓ | ✓ | +| `markers.type` | | | ✓ | ✓ | ✓ | +| `writers.id` | | | | | ✓ | +| `writers.tag` | | | ✓ | ✓ | ✓ | +
+
+Metadata Fields
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `art` | | | | ✓ | ✓ | +| `artBlurHash` | | | | | ✓ | +| `artFile` | | | | | ✓ | +| `audienceRating` | | ✓ | ✓ | ✓ | ✓ | +| `audienceRatingImage` | | ✓ | ✓ | ✓ | ✓ | +| `chapterSource` | | | | ✓ | ✓ | +| `contentRating` | | ✓ | ✓ | ✓ | ✓ | +| `duration` | | ✓ | ✓ | ✓ | ✓ | +| `durationHuman` | | ✓ | ✓ | ✓ | ✓ | +| `grandparentArt` | | | | ✓ | ✓ | +| `grandparentGuid` | | ✓ | ✓ | ✓ | ✓ | +| `grandparentKey` | | | | ✓ | ✓ | +| `grandparentRatingKey` | | ✓ | ✓ | ✓ | ✓ | +| `grandparentTheme` | | | | ✓ | ✓ | +| `grandparentThumb` | | | | ✓ | ✓ | +| `grandparentTitle` | | ✓ | ✓ | ✓ | ✓ | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `hasIntroMarker` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | ✓ | ✓ | ✓ | ✓ | +| `key` | | | | ✓ | ✓ | +| `lastViewedAt` | | | | ✓ | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `originallyAvailableAt` | | ✓ | ✓ | ✓ | ✓ | +| `parentGuid` | | ✓ | ✓ | ✓ | ✓ | +| `parentIndex` | | ✓ | ✓ | ✓ | ✓ | +| `parentKey` | | | | ✓ | ✓ | +| `parentRatingKey` | | ✓ | ✓ | ✓ | ✓ | +| `parentThumb` | | | | ✓ | ✓ | +| `parentTitle` | | ✓ | ✓ | ✓ | ✓ | +| `rating` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `thumbBlurHash` | | | | | ✓ | +| `thumbFile` | | | | | ✓ | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `titleSort` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `userRating` | | ✓ | ✓ | ✓ | ✓ | +| `viewCount` | | | | ✓ | ✓ | +| `viewOffset` | | | | | ✓ | +| `year` | | ✓ | ✓ | ✓ | ✓ | +| `chapters.end` | | | | ✓ | ✓ | +| `chapters.id` | | | | | ✓ | +| `chapters.index` | | | | ✓ | ✓ | +| `chapters.start` | | | | ✓ | ✓ | +| `chapters.tag` | | | | ✓ | ✓ | +| `chapters.thumb` | | | | ✓ | ✓ | +| `directors.id` | | | | | ✓ | +| `directors.tag` | | | ✓ | ✓ | ✓ | +| `fields.locked` | | | ✓ | ✓ | ✓ | +| `fields.name` | | | ✓ | ✓ | ✓ | +| `guids.id` | | | ✓ | ✓ | ✓ | +| `markers.end` | | | ✓ | ✓ | ✓ | +| `markers.start` | | | ✓ | ✓ | ✓ | +| `markers.type` | | | ✓ | ✓ | ✓ | +| `writers.id` | | | | | ✓ | +| `writers.tag` | | | ✓ | ✓ | ✓ | +
+
+ +| 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.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.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.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.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.requiredBandwidths` | | | | | ✓ | +| `media.parts.subtitleStreams.selected` | | | | | ✓ | +| `media.parts.subtitleStreams.streamType` | | | | | ✓ | +| `media.parts.subtitleStreams.title` | | | | ✓ | ✓ | +| `media.parts.subtitleStreams.transient` | | | | | ✓ | +| `media.parts.subtitleStreams.type` | | | | | ✓ | +| `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.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
+
+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.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.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.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.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.requiredBandwidths` | | | | | ✓ | +| `media.parts.subtitleStreams.selected` | | | | | ✓ | +| `media.parts.subtitleStreams.streamType` | | | | | ✓ | +| `media.parts.subtitleStreams.title` | | | | ✓ | ✓ | +| `media.parts.subtitleStreams.transient` | | | | | ✓ | +| `media.parts.subtitleStreams.type` | | | | | ✓ | +| `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.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` | | | | ✓ | ✓ | +
+
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `art` | | | | ✓ | ✓ | +| `artBlurHash` | | | | | ✓ | +| `artFile` | Refer to [Image Exports](#image-export) | | | | | +| `childCount` | | ✓ | ✓ | ✓ | ✓ | +| `collectionMode` | | ✓ | ✓ | ✓ | ✓ | +| `collectionSort` | | ✓ | ✓ | ✓ | ✓ | +| `contentRating` | | ✓ | ✓ | ✓ | ✓ | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | | | | ✓ | +| `key` | | | | ✓ | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `maxYear` | | ✓ | ✓ | ✓ | ✓ | +| `minYear` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `subtype` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `thumbBlurHash` | | | | | ✓ | +| `thumbFile` | Refer to [Image Exports](#image-export) | | | | | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `titleSort` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `fields.locked` | | | ✓ | ✓ | ✓ | +| `fields.name` | | | ✓ | ✓ | ✓ | +| `labels.id` | | | | | ✓ | +| `labels.tag` | | | ✓ | ✓ | ✓ | +| `items` | | ✓
Includes [Items](#collection-item) Level 1 | ✓
Includes [Items](#collection-item) Level 2 | ✓
Includes [Items](#collection-item) Level 3 | ✓
Includes [Items](#collection-item) Level 9 | +
+
+Metadata Fields
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `art` | | | | ✓ | ✓ | +| `artBlurHash` | | | | | ✓ | +| `artFile` | Refer to [Image Exports](#image-export) | | | | | +| `childCount` | | ✓ | ✓ | ✓ | ✓ | +| `collectionMode` | | ✓ | ✓ | ✓ | ✓ | +| `collectionSort` | | ✓ | ✓ | ✓ | ✓ | +| `contentRating` | | ✓ | ✓ | ✓ | ✓ | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `index` | | | | | ✓ | +| `key` | | | | ✓ | ✓ | +| `librarySectionID` | | | | | ✓ | +| `librarySectionKey` | | | | | ✓ | +| `librarySectionTitle` | | | | | ✓ | +| `maxYear` | | ✓ | ✓ | ✓ | ✓ | +| `minYear` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `subtype` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `thumb` | | | | ✓ | ✓ | +| `thumbBlurHash` | | | | | ✓ | +| `thumbFile` | Refer to [Image Exports](#image-export) | | | | | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `titleSort` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `fields.locked` | | | ✓ | ✓ | ✓ | +| `fields.name` | | | ✓ | ✓ | ✓ | +| `labels.id` | | | | | ✓ | +| `labels.tag` | | | ✓ | ✓ | ✓ | +| `items` | | ✓
Includes [Items](#collection-item) Level 1 | ✓
Includes [Items](#collection-item) Level 2 | ✓
Includes [Items](#collection-item) Level 3 | ✓
Includes [Items](#collection-item) Level 9 | +
+
+ +| Media Info Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `items` | | ✓
Includes [Items](#collection-item) Level 1 | ✓
Includes [Items](#collection-item) Level 2 | ✓
Includes [Items](#collection-item) Level 3 | ✓
Includes [Items](#collection-item) Level 9 | +
+
+* **Note:** Collection `items` can be [Movies](#movie) or [Shows](#show) depending on the collection.
+
+
+### Playlists
+
+Media Info Fields
+ +| Media Info Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `items` | | ✓
Includes [Items](#collection-item) Level 1 | ✓
Includes [Items](#collection-item) Level 2 | ✓
Includes [Items](#collection-item) Level 3 | ✓
Includes [Items](#collection-item) Level 9 | +
+
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `composite` | | | | ✓ | ✓ | +| `duration` | | ✓ | ✓ | ✓ | ✓ | +| `durationHuman` | | ✓ | ✓ | ✓ | ✓ | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `key` | | | | ✓ | ✓ | +| `leafCount` | | | | | ✓ | +| `playlistType` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `smart` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `items` | | ✓
Includes [Items](#playlist-item) Level 1 | ✓
Includes [Items](#playlist-item) Level 2 | ✓
Includes [Items](#playlist-item) Level 3 | ✓
Includes [Items](#playlist-item) Level 9 | +
+
+Metadata Fields
+ +| Metadata Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `addedAt` | | ✓ | ✓ | ✓ | ✓ | +| `composite` | | | | ✓ | ✓ | +| `duration` | | ✓ | ✓ | ✓ | ✓ | +| `durationHuman` | | ✓ | ✓ | ✓ | ✓ | +| `guid` | | ✓ | ✓ | ✓ | ✓ | +| `key` | | | | ✓ | ✓ | +| `leafCount` | | | | | ✓ | +| `playlistType` | | ✓ | ✓ | ✓ | ✓ | +| `ratingKey` | | ✓ | ✓ | ✓ | ✓ | +| `smart` | | ✓ | ✓ | ✓ | ✓ | +| `summary` | | ✓ | ✓ | ✓ | ✓ | +| `title` | | ✓ | ✓ | ✓ | ✓ | +| `type` | | ✓ | ✓ | ✓ | ✓ | +| `updatedAt` | | | | ✓ | ✓ | +| `items` | | ✓
Includes [Items](#playlist-item) Level 1 | ✓
Includes [Items](#playlist-item) Level 2 | ✓
Includes [Items](#playlist-item) Level 3 | ✓
Includes [Items](#playlist-item) Level 9 | +
+
+ +| Media Info Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `items` | | ✓
Includes [Items](#playlist-item) Level 1 | ✓
Includes [Items](#playlist-item) Level 2 | ✓
Includes [Items](#playlist-item) Level 3 | ✓
Includes [Items](#playlist-item) Level 9 | +
+
+* **Note:** Playlist `items` can be [Movies](#movie), [Episodes](#episode), [Tracks](#track), or [Photos](#photo) depending on the playlist.
diff --git a/docs/Frequently-Asked-Questions.md b/docs/Frequently-Asked-Questions.md
new file mode 100644
index 00000000..dc5a2a08
--- /dev/null
+++ b/docs/Frequently-Asked-Questions.md
@@ -0,0 +1,686 @@
+**If you can't find a solution here, please ask on [Discord](https://discord.gg/tQcWEUp), [Reddit](https://www.reddit.com/r/Tautulli) or the [Plex Forums](https://forums.plex.tv/discussion/307821/tautulli-monitor-your-plex-media-server). Don't post questions on the GitHub issues tracker.**
+
+## General
+
+* [I am receiving some weird datatable warnings.](#general-q2)
+* [I forgot my username and/or password!](#general-q3)
+* [I can't reach the web interface!](#general-q4)
+* [Tautulli is not updating, it just goes back to the homepage without updating.](#general-q5)
+* [When I try to update Tautulli, it keeps telling me "Please commit your changes or stash them before you can merge."](#general-q6)
+* [What does the warning "Unable to retrieve data" mean? Is this a problem?](#general-q7)
+* [My libraries are duplicated! How do I remove them?](#general-q8)
+* [How can I access Tautulli outside my home network?](#general-q9)
+* [Why does Tautulli not work with my reverse proxy setup?](#general-q10)
+* [I need to move/reinstall Tautulli. Can I keep my history and statistics?](#general-q11)
+* [Help! I accidentally deleted a user/library! How can I add it back?](#general-q12)
+* [Can I import my history from PlexWatch/Plexivity?](#general-q13)
+* [Where can I find my Tautulli logs?](#general-q14)
+* [Tautulli says "There was an error communicating with your Plex Server", and the logs say "Status code 401".](#general-q16)
+* [I can't connect to my Plex server with "Use SSL" checked.](#general-q17)
+* [My Tautulli database got corrupted: "DatabaseError: database disk image is malformed" or "sqlite3.OperationalError".](#general-q18)
+* [Tautulli cannot read my Plex log file.](#general-q19)
+* [Tautulli won't start due to a corrupted config file.](#general-q20)
+* [What data is being collected using Google Analytics?](#general-q21)
+* [I'm seeing an "Unable to connect to remote host because of a SSL error." message when trying to update.](#ssl-update)
+* [Does Tautulli have to be installed on the same machine as my Plex Server?](#install-same-machine-plex)
+* [Recently added items are not showing up on the homepage.](#recently-added-homepage)
+* [My users list is not updating and I am seeing "Status code 404" in the logs.](#users-list-not-updating)
+* [My media info table is not loading.](#media-info-table-not-loading)
+
+## Activity and History Logging
+
+* [What is the grey progress bar under the current activity?](#history-q2)
+* [I can see the streams on the homepage, but nothing is being logged.](#history-q3)
+* [Do I need to keep Tautulli running to record history?](#history-q4)
+* [Can Tautulli import history from before it was installed?](#history-q5)
+* [Watch history isn't showing up under "Recently Watched" on the homepage.](#history-q6)
+* [After resuming a media item, it shows up as two plays in Tautulli.](#history-q7)
+* [The logs keep telling me "Failed to write sessionKey XX ratingKey YY to the database. Will try again on the next pass."](#history-q8)
+* [Can I see which items in my libraries are the *least watched*?](#history-q9)
+* [My concurrent streams statistic is showing an insane number!](#history-q10)
+* [I am seeing history entries with very long duration times.](#history-q11)
+* [Why does the bandwidth show as higher than the quality?](#history-q12)
+* [I moved media in Plex, now Tautulli is linking to the wrong item/showing up twice!](#move-media)
+* [I'm seeing the same artist twice on the homepage!](#homepage-duplicate-artist)
+* [Why are items showing up as 127.0.0.1 for the IP address?](#plex-relay)
+* [Can I disable history logging for a specific user/library?](#disable-logging)
+
+## Live TV
+
+* [Why do I suddenly have a "Live TV" library?](#livetv-library)
+* [Why don't I see the "Live TV" library?](#livetv-library-missing)
+* [I played multiple shows on Live TV but Tautulli says I only watched one show the entire time.](#livetv-rollover)
+* [How do I disable history logging for Live TV?](#livetv-disable-logging)
+* [Can I view the history for an entire TV show I watched on Live TV similar to TV shows in my own library?](#livetv-show-history)
+* [How do I hide Live TV on the Graphs page?](#livetv-hide-graphs)
+
+## Notifications
+
+* [I can't get Notifications working! Is there a magic trick?](#notifications-q1)
+* [My tests say they are successful, but the notification isn't sent and there's nothing in the logs.](#notifications-q2)
+* [Can I disable notifications for a specific user/library?](#notifications-q3)
+* [Can I disable recently added notifications for TV Shows/Movies?](#notifications-q4)
+* [All my recently added notifications are showing `S00E01`.](#notifications-q5)
+* [Why are posters not showing up in my notifications?](#notifications-q7)
+* [How do I set up Imgur for notification posters?](#imgur)
+* [Facebook notifications are telling me "Insufficient permission to post to target on behalf of the viewer".](#notifications-q9)
+* [Facebook notifications are telling me "Some of the aliases you requested do not exist".](#notifications-q10)
+* [I'm seeing a "The PyCryptodome library is missing." message!](#notifications-pycryptodome)
+* [Notifications are sending the wrong text/sending the default text.](#notifications-text-ignored)
+* [How do I override the Python version in a script?](#notifications-override-python)
+* [My recently added notifications are not sending and the logs say "Not notifying again".](#notifications-not-notifying-again)
+* [My playback stop notifications are not working.](#stop-notifications)
+
+## Newsletters
+
+* [I enabled a library but it's not showing in the newsletter!](#newsletter-recently-added-library)
+* [Gmail is giving me a "Message clipped" message!](#message-clipped)
+* [How do I edit the date format?](#newsletter-date-format)
+* [Images are not showing up in my newsletter emails.](#newsletter-missing-images)
+* [I want to customize the newsletter.](#newsletter-custom-template)
+
+## Windows
+
+* [I enabled HTTPS but received a warning that the pyOpenSSL module is missing. How do I fix this?](#windows-q1)
+* [Tautulli keeps telling me "You're running an unknown version of Tautulli."](#windows-q2)
+* [When trying to update, the logs say "Invalid update data, update failed."](#windows-q3)
+* [I am getting a "DatabaseError: file is encrypted or is not a database"!](#windows-q4)
+* [How can I run Tautulli without the command prompt staying open?](#windows-q5)
+* [The command prompt just flashes open then closes immediately when starting Tautulli.](#windows-q6)
+
+## OSX
+
+* [When trying to update, the logs say "Agreeing to the Xcode/iOS license requires admin privileges, please re-run as root via sudo."](#osx-q1)
+* [I'm getting a `ValueError: unknown locale: UTF-8` message](#osx-unknown-locale)
+* [How do I get rid of the Python rocket icon in my dock?](#osx-python-dock)
+
+## QNAP
+
+* [How do I set the Plex Logs Folder on QNAP?](#qnap-q1)
+
+---
+
+### General
+
+#### Q: I am receiving some weird datatable warnings.
+**A:** Most datatable warnings can be solved by doing a force refresh in your browser (CTRL+F5 or OPTION+Reload on Mac/Safari). If that doesn't work, try clearing your browser's cache.
+
+#### Q: I forgot my username and/or password!
+**A:** Follow these steps to get back in:
+1. **Shut down** Tautulli so your changes will apply.
+2. Open the Tautulli `config.ini` file with your preferred text editor.
+3. Search for `http_username` and `http_password` and the values after the equal signs are the username and password. You can also delete both lines from the file to disable authentication.
+
+_Note: If your password is encrypted in the config file, you will have to delete the entire line to disable authentication and reset your password in the Tautulli settings._
+
+#### Q: I can't reach the web interface!
+**A:** Shut down Tautulli and open the Tautulli `config.ini` file with your preferred text editor, search for the lines that begin with `http_host`, `http_port`, and `http_root` and remove the entire line. You should also remove the line for `enable_https` from the file. After you have removed these lines from `config.ini`, go ahead and start Tautulli. It will listen on the default IP address and port (`http://localhost:8181`).
+
+#### Q: Tautulli is not updating, it just goes back to the homepage without updating.
+**A:** When you try you Tautulli and you get the message "A newer version (vX.Y.ZZ) is available", but updating doesn't actually update Tautulli there are two ways you can solve the problem, depending on how you installed Tautulli.
+
+##### Git based installation
+
+If you installed Tautulli by cloning the `git` repository, it's possible your local `git` repository has gotten out of sync in a manner that Tautulli can't automatically update from.
+
+If you are running Tautulli v2.2.0 or newer you can have Tautulli attempt to fix this itself by going to Settings -> General -> [Show Advanced] -> Repair Git Install -> Reset. This will attempt to automatically run the commands described below for you, cleaning up some common issues.
+
+If you are running an older version of Tautulli, or the above didn't work, you will need to manually fix this. First **Shutdown Tautulli**, then run the following commands from the command line/shell in the Tautulli folder.
+```sh
+git remote set-url origin https://github.com/Tautulli/Tautulli.git
+git fetch origin
+git checkout master
+git branch -u origin/master
+git reset --hard origin/master
+git pull
+```
+
+If you are running Tautulli as a dedicated user as is recommended in the [Daemon instructions](Install-as-a-daemon), it's likely the permissions on files will need to be fixed after running the above commands:
+```sh
+sudo chown -R tautulli:tautulli /path/to/Tautulli
+```
+
+##### ZIP install
+
+If you instead installed Tautulli by simply downloading the current release archive, the steps are simpler:
+1. Download the [current release](https://github.com/Tautulli/Tautulli/zipball/master)
+2. Shut down Tautulli
+3. Extract the current release to the same location where you previously extracted it
+ * Note: You should be _replacing_ the existing files, if you are prompted about this please select to replace the files!
+4. If needed, ensure the permissions are correct
+ * For example: `sudo chown -R tautulli:tautulli /path/to/Tautulli`
+5. Start Tautulli
+
+#### Q: When I try to update Tautulli, it keeps telling me "Please commit your changes or stash them before you can merge."
+**A:** See the answer to the previous question.
+
+#### Q: What does the warning "Unable to retrieve data" mean? Is this a problem?
+**A:** No, not necessarily. It means that you requested data that is not available, for example when you view the profile of a user who hasn't watched anything yet or view synced items when there is nothing synced.
+
+#### Q: My libraries are duplicated! How do I remove them?
+**A:** This usually happens when you try to reinstall or switch your Plex Media Server. You can visit the following URL to remove all libraries not associated with the current Plex server connected to Tautulli.
+
+```
+http://localhost:8181/delete_duplicate_libraries
+```
+
+If the libraries are duplicated on the homepage, toggle the Library Statistic cards under Settings > Homepage and click Save.
+
+#### Q: How can I access Tautulli outside my home network?
+**A:** **WARNING:** Before you follow any of these methods make sure you have enabled authentication in Tautulli under Settings -> Web Interface by setting a HTTP Username and Password. If you load Tautulli in an Incognito window you should get a login prompt!
+
+The easy and least secure method is to forward an external port (`8181`) on your router to the internal port used by Tautulli (default is TCP `8181`). Visit [Port Forward](http://portforward.com/) for instructions for your particular router. You will then be able to access Tautulli via `http://EXTERNAL-IP-ADDRESS:8181`.
+
+The more advanced and most preferred method (and more secure if you use SSL) is to set up a web server with NGINX/Apache, and use a reverse proxy to access Tautulli. You can lookup many guides on the internet to find out how to do this.
+
+The most secure method, but also the most inconvenient, is to set up a VPN tunnel to your home server, then you can access Tautulli as if it is on a local network via `http://LOCAL-IP-ADDRESS:8181`.
+
+#### Q: Why does Tautulli not work with my reverse proxy setup?
+**A:** Tautulli uses CherryPy as it's web server, and it includes support for reverse proxies. You must ensure that your proxy web server (e.g. NGINX or Apache) is sending the standard `X-` headers to CherryPy. For **NGINX**, the configuration would look like this:
+
+```nginx
+# Standard proxying headers
+proxy_set_header Host $host;
+proxy_set_header X-Real-IP $remote_addr;
+proxy_set_header X-Forwarded-Host $server_name;
+proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+```
+
+If you have SSL enabled on your webserver (e.g. `Internet --> https://nginx --> http://tautulli`), make sure HTTP Proxy is checked under Settings > Show Advanced button > Web Interface. Then ensure that your proxy web server is also including these two SSL specific `X-` headers:
+
+```nginx
+# SSL proxying headers
+proxy_set_header X-Forwarded-Proto $scheme;
+proxy_set_header X-Forwarded-Ssl on;
+```
+
+As an alternative, the following configuration will automatically work for both HTTP and HTTPS.
+```nginx
+location /tautulli/ {
+ proxy_pass http://127.0.0.1:8181;
+ proxy_set_header Host $host;
+ proxy_set_header X-Forwarded-Host $server_name;
+ proxy_set_header X-Real-IP $remote_addr;
+ proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+ proxy_read_timeout 90;
+ proxy_set_header X-Forwarded-Proto $scheme;
+ set $xforwardedssl "off";
+ if ($scheme = https) {
+ set $xforwardedssl "on";
+ }
+ proxy_set_header X-Forwarded-Ssl $xforwardedssl;
+ proxy_redirect ~^(http(?:s)?://)([^:/]+)(?::\d+)?(/.*)?$ $1$2:$server_port$3;
+}
+```
+
+Don't forget to clear your web browser's cache *every* time you update your web server configuration.
+
+#### Q: I need to move/reinstall Tautulli. Can I keep my history and statistics?
+**A:** Yes, all you need to do is download a copy your `tautulli.db` database file and `config.ini` configuration file by clicking on the "Database File" and "Configuration File" links on the Settings > Help & Info page. Then after reinstalling and completing the setup wizard, go to the Settings > Import & Backup page to import the old `tautulli.db` database and `config.ini` configuration files. This will work between any OS.
+
+**WARNING**: If you are re-installing Plex as well please follow [their guide to Move an Install to Another System](https://support.plex.tv/articles/201370363-move-an-install-to-another-system/). If you are starting from scratch again with Plex, or forgot to do this step, then you **MUST** run the script from [this FAQ entry](#move-media), or your Tautulli database will link to the wrong items!
+
+#### Q: Help! I accidentally deleted a user/library! How can I add it back?
+**A:** If you have deleted a user or library in Tautulli and would like to bring them back the best method is to immediately restore a backup as the related history for these are removed when they are deleted. If you no longer have a backup containing the history, or don't want to bother with recovering it, you can simply tell Tautulli to allow them back in by "undeleting" them with the following instructions.
+
+##### Undeleting a user
+If you are trying to undelete a user first you will need to find their `user_id`. You can get this by following the "More XML Shortcuts" instructions [here](Debugging#more-xml-shortcuts) for "All Users".
+
+You will see a list of items, find the entry that corresponds to the user you want to undelete, the `user_id` is in the `id="12345"` part. So for example in this entry the `user_id` would be `8367478`:
+```xml
+Media Info Fields
+ +| Media Info Field | Level 0 | Level 1 | Level 2 | Level 3 | Level 9 | +| :--- | :---: | :---: | :---: | :---: | :---: | +| `items` | | ✓
Includes [Items](#playlist-item) Level 1 | ✓
Includes [Items](#playlist-item) Level 2 | ✓
Includes [Items](#playlist-item) Level 3 | ✓
Includes [Items](#playlist-item) Level 9 | +
+
+
+## macOS
+
+Download and run the latest macOS `.pkg` installer from the [GitHub Releases page](https://github.com/Tautulli/Tautulli/releases/latest).
+
+* Note: The `.pkg` installer requires macOS 10.14 (Mojave) or newer. For macOS 10.13 (High Sierra) and older please use the alternate installation instructions below.
+
+Alternate installation instructions
+ +* Download the latest version of [Python](https://www.python.org/downloads/) and complete the installation with all the default options. + +* Option 1 (easy): + * Download Tautulli from GitHub: https://github.com/Tautulli/Tautulli/zipball/master + * Extract the ZIP file. + * Double click `start.bat` to run Tautulli. + * Tautulli will be loaded in your browser or listening on http://localhost:8181. + +* Option 2 (preferred): + > **NOTE**: This will install extra shell extensions and make adjustments to your path environment. + + * Go to https://gitforwindows.org/ and download `git`. + * Run the installer, select all the defaults except for the section called "Adjusting your PATH environment" - here select **"Git from the command line and also from 3rd-party software"**. + * Complete the rest of the installation with the default options. + * Right click on your desktop and select "Git Gui". + * Select "Clone Existing Repository". + * In the "Source Location" enter: `https://github.com/Tautulli/Tautulli.git` + * In the "Target Directory" enter a new folder where you want to install Tautulli to (e.g. `C:\Tautulli`). + * Click "Clone". + * When it's finished a Git Gui windows will appear, just close this Window. + * Browse to where you cloned the Tautulli repository (e.g. `C:\Tautulli`) in Windows Explorer. + * Double click `start.bat` to run Tautulli. + * Tautulli will be loaded in your browser or listening on http://localhost:8181. +
+
+
+## Linux
+
+Tautulli can be installed on most Linux distribution using a Snap.
+
+1. Select your Linux distribution at the bottom of the [Tautulli Snapcraft page](https://snapcraft.io/tautulli) to install `snapd`.
+ * If your Linux distribution is not listed, additional instructions can be found [here](https://snapcraft.io/docs/installing-snapd).
+1. Install Tautulli: `sudo snap install tautulli`
+1. Tautulli will be loaded in your browser or listening on http://localhost:8181/
+
+Alternate installation instructions
+ +Tautulli will be installed to `/Applications/Tautulli` + +* Option 1 (easy): + * Download Tautulli from GitHub: https://github.com/Tautulli/Tautulli/zipball/master + * Extract the zip to `/Applications/Tautulli`. Make sure you extract the files directly in the root. + * Open a terminal + * Type: `cd /Applications/Tautulli` +* Option 2 (preferred): + * Open a terminal + * Install Git. This can be done via `xcode-select --install` + * Type: `cd /Applications/` + * Type: `git clone https://github.com/Tautulli/Tautulli.git` + * Type: `cd Tautulli` +* Type: `./start.sh` to run Tautulli. +* Tautulli will be loaded in your browser or listening on http://localhost:8181. +
+
+
+
+## FreeBSD / FreeNAS
+
+Tautulli will be installed to `/usr/local/share/Tautulli`.
+
+1. Create a new jail for Tautulli and open a terminal for the jail.
+1. Install prerequisites:
+`pkg install python py37-setuptools py37-sqlite3 py37-openssl py37-pycryptodomex security/ca_root_nss git-lite`
+1. Change directory: `cd /usr/local/share`
+1. Clone Tautulli: `git clone https://github.com/Tautulli/Tautulli.git`
+1. Add the Tautulli user: `pw useradd -n tautulli -c "Tautulli" -s /sbin/nologin -w no`
+1. Change ownership: `chown -R tautulli:tautulli Tautulli`
+1. Copy the service script: `mkdir -p /usr/local/etc/rc.d && cp /usr/local/share/Tautulli/init-scripts/init.freenas /usr/local/etc/rc.d/tautulli`
+1. Enable the service: `sysrc -f /etc/rc.conf tautulli_user="tautulli" && sysrc -f /etc/rc.conf tautulli_enable="YES"`
+1. Start Tautulli: `service tautulli start`
+1. Tautulli will be loaded in your browser or listening on http://localhost:8181
+
+#### Note:
+
+* Refer to the instructions in the service file to run Tautulli using a different user or move your Tautulli data to a different location:
+ * https://github.com/Tautulli/Tautulli/blob/master/init-scripts/init.freebsd
+
+
+## Docker
+
+### Using `docker run`
+
+Create and run the container (substitute your `Alternate installation instructions
+ +Tautulli will be installed to `/opt/Tautulli`. + +1. Open a terminal. +1. Install prerequisites: + * Ubuntu/Debian: `sudo apt-get install git python3.7 python3-setuptools` + * Fedora: `sudo yum install git python3 python3-setuptools` +1. Change directory: `cd /opt` +1. Clone Tautulli: `sudo git clone https://github.com/Tautulli/Tautulli.git` +1. Add the Tautulli user: + * Ubuntu/Debian: `sudo addgroup tautulli && sudo adduser --system --no-create-home tautulli --ingroup tautulli` + * CentOS/Fedora: `sudo adduser --system --no-create-home tautulli` +1. Change ownership: `sudo chown -R tautulli:tautulli /opt/Tautulli` +1. Copy the service script: `sudo cp /opt/Tautulli/init-scripts/init.systemd /lib/systemd/system/tautulli.service` +1. Enable the service: `sudo systemctl daemon-reload && sudo systemctl enable tautulli.service` +1. Start Tautulli: `sudo systemctl start tautulli.service` +1. Tautulli will be loaded in your browser or listening on http://localhost:8181 + +#### Note: + +* Refer to the instructions in the service file to run Tautulli using a different user or move your Tautulli data to a different location: + * https://github.com/Tautulli/Tautulli/blob/master/init-scripts/init.systemd +
+`) and fill in the Tautulli setting. If you have customized the URL and no longer have easy access to the Group ID, see [this answer](https://stackoverflow.com/questions/8957340/how-do-i-find-my-facebook-group-id) for how to obtain it. _Note:_ You should _only_ put the ID in the setting for Tautulli, not the full URL.
+
+
+---
+
+### GroupMe
+
+1. Go to [GroupMe Developers](https://dev.groupme.com) and click **Access Token** at the top. Copy the token and fill in the Tautulli setting.
+1. Go to the **Bots** tab at the top and click **Create Bot**.
+1. Select the group chat where you want the notifications to be sent, give your bot a **Name** and **Avatar**, and click `Submit`. All other fields can be left at their default values.
+1. Copy the **Bot ID** and fill in the Tautulli setting.
+
+---
+
+### Growl
+
+1. Open Growl and go to the General tab to make sure Growl is turned `On` and running.
+1. Optional: Go to the Security tab to set up a **Password**. Check "Allow network notifications" if Growl is running on a separate machine than Tautulli.
+1. Fill in the **Host** for the machine running Growl (e.g. `localhost` or `192.168.0.100`) in the Tautulli settings.
+1. Fill in the **Password**, if required, in the Tautulli settings.
+
+---
+
+### Hipchat
+
+1. Go to [Hipchat Integrations](https://www.hipchat.com/addons/), select the room where you want the notifications to be sent, and click **Build your own integration**.
+1. Give your integration a **Name** and click `Create`.
+1. Copy the **Integration URL** and fill in the Tautulli setting.
+
+---
+
+### IFTTT
+
+1. Go to IFTTT and set up your [Webhooks](https://ifttt.com/maker_webhooks) service.
+1. Click on **Documentation** to get your **Webhook Key** and fill in the Tautulli setting.
+1. Create a [New Applet](https://ifttt.com/create), with "this" as "Webhooks", and the trigger "Receive a web request".
+1. Fill in the **Event Name** with the one that matches the Tautulli setting.
+ * **Tip:** You can create different IFTTT events (e.g. `tautulli_play`, `tautulli_stop`, `tautulli_created`, etc.) by adding `{action}` to the Event Name in Tautulli (e.g. `tautulli_{action}`).
+1. Select "that" as whichever service you want.
+1. Fill in the settings of your service by adding the ingredients `Value1`, `Value2`, and `Value3`.
+ * `Value1` will be the subject line in your notification text settings.
+ * `Value2` will be the body text in your notification text settings.
+ * (Optional) `Value3` can be anything you select (e.g. Poster URL).
+
+---
+
+### Join
+
+1. Go to [Join App](https://joinjoaomgcd.appspot.com), and click on `Join API`, then `Show`.
+1. Copy the **API Key** and fill in the Tautulli setting.
+
+---
+
+### Kodi
+
+1. From within Kodi, go to Settings > Service settings > Control, and make sure "Allow remote control via HTTP" is checked.
+1. Optional: Set the **Port**, **Username**, and **Password** for the Kodi Webserver. The default port is `8080`.
+1. Enter in the **Host Address** for the machine running Kodi (e.g. `http://localhost:8080`) in the Tautulli settings.
+1. Fill in the **Username** and **Password**, if required, in the Tautulli settings.
+
+---
+
+### macOS Notification Center
+
+**Note:** macOS Notification Center notifications will only work on the machine where Tautulli is installed.
+
+1. Fill in the path to your Tautulli application. The default is `/Applications/Tautulli`.
+1. Click the `Register App` button to register Tautulli with the Notification Center.
+
+---
+
+### MQTT
+
+1. Fill in the settings from your MQTT broker.
+
+---
+
+### Notify My Android
+
+1. Go to [Notify My Android](https://notifymyandroid.appspot.com/account.jsp) and click `Generate New Key`.
+2. Copy the **API Key** and fill in the Tautulli setting.
+
+---
+
+### Plex Home Theater
+
+**Note:** Plex Home Theater notifications only work with [OpenPHT](https://forums.plex.tv/discussion/264209/release-openpht-1-8-0/p1) or [RasPlex](https://forums.plex.tv/discussion/264208/release-rasplex-1-8-0/p1).
+
+1. From within OpenPHT/RasPlex, go to Preferences > System > Services, and make sure "Allow remote control via HTTP" is checked.
+1. Enter in the **Host Address** for the machine running OpenPHT or RasPlex with the port `3005` (e.g. `http://localhost:3005`).
+1. Fill in the **Username** and **Password**, if required, in the Tautulli settings.
+
+---
+
+### Plex Android / iOS App
+
+**Note:** Plex Pass is required to send notifications to the Plex mobile apps.
+
+1. Open the Plex Android or iOS app, go to Settings > Notifications and enable the following notifications matching the triggers in the Tautulli notification agent:
+ 1. **New Content Added to Library** - Tautulli trigger: Recently Added
+ * Note: Make sure to *uncheck* all libraries for the server connected to Tautulli.
+ 1. **Playback Started** - Tautulli trigger: Playback Start
+ * Note: Make sure to *uncheck* the server and all users connected to Tautulli.
+ 1. **New Devices** - Tautulli trigger: User New Device
+ * Note: Make sure to *uncheck* the server connected to Tautulli.
+1. Send a Test Notification from Tautulli and you should receive one test notification *for each notification* you have enabled in the Plex App.
+
+**Note:** The user(s) receiving the notifications must have notifications enabled for the matching Tautulli triggers in their Plex mobile app.
+
+**Note:** The user(s) must *uncheck* all the servers, libraries, and users connected to Tautulli in the Plex mobile app settings otherwise they may receive duplicate notifications from Plex and Tautulli. Use the [custom notification agent conditions](Custom-Notification-Conditions) in Tautulli to filter the notifications instead.
+
+**Note:** Push notifications do not need to be enabled in your Plex server Settings > General page. However, you may leave it enabled to receive the other notifications types from Plex (new server shared with you, new item on deck, database corruption detected, database backed up, etc.).
+
+---
+
+### Prowl
+
+1. Go to [Prowl](https://www.prowlapp.com/api_settings.php), and generate a new API key by clicking `Generate Key`.
+1. Copy the **API Key** and fill in the Tautulli Setting.
+
+---
+
+### Pushbullet
+
+1. Go to [Pushbullet Account Settings](https://www.pushbullet.com/#settings/account), and click `Create Access Token`.
+1. Copy the **Access Token** and fill in the Tautulli Setting.
+
+---
+
+### Pushover
+
+1. Go to Pushover, and [Create a New Application](https://pushover.net/apps/build).
+1. Give your application a **Name** and **Icon**, and click `Create Application`.
+1. Copy the **API Token** and fill in the Tautulli Setting.
+1. Go back to the [Pushover homepage](https://pushover.net).
+ * If you want to send notifications to yourself, copy your **User Key** and fill in the Tautulli setting.
+ * If you want to send notifications to a group, go to [Create a New Group](https://pushover.net/groups/build). Copy the **Group Key** and fill in the Tautulli setting.
+
+---
+
+### Script
+
+* Please see the [[Custom Scripts Wiki Page|Custom Scripts]].
+
+---
+
+### Slack
+
+1. Go to Slack, and create a new [Incoming Webhook](https://my.slack.com/services/new/incoming-webhook).
+1. Select the slack channel where you want the notifications to be sent, and click `Add Incoming Webhooks integration.
+1. Copy your **Webhook URL** and fill in the Tautulli setting.
+1. Scroll down to Integration Settings, and give your integration a **Name** and **Icon**. This can be changed in the Tautulli settings instead if you wish.
+
+---
+
+### Tautulli Remote Android App
+
+* Please see the [Tautulli Remote Wiki](https://github.com/Tautulli/Tautulli-Remote/wiki/Registering-a-Tautulli-server) on how to register your [Tautulli Remote Android App](https://play.google.com/store/apps/details?id=com.tautulli.tautulli_remote).
+
+---
+
+### Telegram
+
+1. Message [`@BotFather`](https://telegram.me/BotFather) on Telegram with the command `/newbot` to create a new bot.
+1. Follow the instructions to give your bot a display name and a bot username.
+1. Copy the **Bot Token** and fill in the Tautulli setting.
+
+**Sending Messages to Yourself**
+
+1. Create a new chat with your bot.
+1. Message [`@IDBot`](https://telegram.me/myidbot) on Telegram with the command `/getid` to get your **Chat ID**.
+1. Copy the **Chat ID** and fill in the Tautulli setting.
+
+**Sending Messages to a Group**
+
+1. Create a new group chat with your bot and [`@IDBot`](https://telegram.me/myidbot).
+1. Message [`@IDBot`](https://telegram.me/myidbot) in the group with the command `/getgroupid` to get your **Group ID**.
+1. Copy the **Group ID** and fill in the Tautulli setting. Don't forget the hyphen (`-`) in the Group ID.
+
+**Sending Messages to a Channel**
+
+1. Create a new Public Channel in Telegram.
+1. Go to Manage Channel and add your bot to the Administrators.
+1. Add a "Link" to your channel. This is your channel username (e.g. `t.me/