Item Information
Library items have a number of interesting properties. Among these are, but not limited to:
- Name
- Id
- Budget
- CriticRating
- CriticRatingSummary
- DateCreated
- GameSystem
- Genres
- HomePageUrl
- IsHD
- Language
- Overview
- ParentId
- Path
- People
- Players
- ProductionYear
- Revenue
- RunTimeTicks
- SeasonCount
- SortName
- Studios
- Taglines
- Type
When retrieving a single item, the entire object is returned. When querying for items, the return data will be stripped to include only a minimal amount of information. When querying, you can configure the fields that are returned in the output. See browsing the Library.
Here are some other properties along with their descriptions:
These are applicable to Series only and will give you information about when episodes air.
These are applicable to audio files only.
This is generally the original aspect ratio that the video was filmed in. The actual aspect ratio of the user's video can be found in the MediaStreams property.
This will tell you how many backdrop images are available for an item. See images.
This is applicable to videos only. This will give you the list of chapter markers contained within the video.
For folders, this indicates the number of child items available.
This is the Imdb, Tmdb, or Tvdb rating of the item. At this time we do not have the ability to identify the source.
This is the date an item ended. For Persons this represents death date. For series that have ended, this is the air date of the final episode.
This will tell you what images are available for an item. See images.
This serves different purposes depending on the type of item. For episodes this is the episode number. For seasons, this is the season number. For audio files, this is the track number.
Denotes the ending index number, in case a file spans multiple episodes.
These allow you to determine how to categorize and display items. See Browsing the Library
MediaTypes: Audio, Video, Book, Game, Photo.
This setting is applicable to videos only. If a video is an Iso this will give you the type - Dvd or BluRay.
LocalTrailerCount is the number of downloaded local trailers that are available for an item. The actual trailer items can be retrieved separately using /Users/{UserId}/Items/{Id}/LocalTrailers.
RemoteTrailers are a list of known online trailers. When supporting trailers, precedence should be given to downloaded trailers. It is up the client developer as to whether or not they just want to pick one, or present all of them in a list. The most common scenario is that the user will have just one local trailer.
This indicates if the item is a file system item, remote, or virtual.
FileSystem items are items the user has physical copies of on their file system. Remote items point to a url address. Virtual items entirely virtual and are not playable (e.g. missing episodes).
This is applicable to Audio and Video only. This will provide detailed information about the audio, video and subtitle tracks embedded within the file.
G, PG-13, R, TV-MA, etc.
An html version of the overview, possibly with links embedded.
This is for Artists and indicates if they are currently on tour.
Similiar to IndexNumber, this serves different purposes depending on the type of item. For episodes this is the season number. For audio files, this is the disc number.
See images.
These are the people involved in the item. Each person has Name, Role, Type and PrimaryImageTag properties.
This is populated for folders to indicate the user's cumulative progress through all items in the folder.
This serves different purposes depending on the type of item. For episodes and series, this is the first air date. For movies, albums and songs, this is the release date. For persons this is date of birth. For artists, this is their formation date.
This is the aspect ratio of the primary image. Most image types have a predictable aspect ratio, but primary is the one exception. A typical use case when rendering a list of items is to determine the average AR, and then display them all using that value. See images.
This is a dictionary of provider id's for an item - Tmdb, Tvdb, TvCom, etc.
A list of known provider id's can be found here, although plugins can inject additional ones.
This is a list of strings indicating filming locations. For Persons, this will have one entry and will contain their place of birth.
For folders, this indicates the number of items available, recursively.
These properties are applicable only to Episodes and Seasons. This will give you some basic information about the TV Series.
For Movies, Games and Series. It is a list of album id's in case you want to display the soundtracks. For MusicAlbums, it is the opposite, it is the list of items that the album is the soundtrack for.
This is applicable to Movies only. This will tell you how many special features are available. The actual special feature items can then be retrieved using /Users/{UserId}/Items/{Id}/SpecialFeatures.
Contains user state for an item, such as personal rating and playstate.
The 3D format, if applicable.
This is applicable to Videos only. This will give you the type of video - VideoFile, Bluray, Dvd, HdDvd, Iso.
- Locating the Server
- Emby Connect
- Browsing the Library
- Latest Items
- Item Information
- Item Types
- Images
- Items by Name
- Web Socket
- Remote Control
- Live TV
- Playlists
- Parental Control
- Filtering
- Sync
- Playback Guidelines
- Audio Streaming
- Video Streaming
- HTTP Live Streaming (HLS)
- Subtitles
- Playback Check-ins