Home > Devices > Amazon Fire TV

Integrating Your Catalog with Fire TV


Edit on GitHub

Integrating your media catalog with Amazon Fire TV allows your content to be discovered and launched from the Fire TV home screen. Catalog Integration has two major components:

  • A catalog file that specifies the movies and TV shows that you offer through your app.
  • Integration between your app and the Fire TV Home Screen Launcher, which enables users to play your content directly from search and browse results.

Catalog Integration allows your content to be included in the results of a search performed from the Fire TV home screen. It also allows a user to find your content while browsing Fire TV outside of your app, such as when browsing by genre (also known as “universal browse and search”). Regardless of where in the Fire TV UI users find your content, they can play it directly without needing to open your app first.

Resources in This Section

These topics will teach you about Fire TV catalog and launcher integration. If you’re new to this, reading these topics in the given order is recommended.

Read these topics as needed:

These documents can be used as a reference once you have a grasp of the overall catalog and launcher integration concepts.

Changes to the Catalog Data Format (CDF) XML Schema

From time to time, the CDF schema, on which your catalog file is based, is updated to add new features. In rare cases, existing elements might be removed or altered. Check here for a summary of the latest changes. See Migrating a Catalog Data Format (CDF) File to the Latest Version) for more detailed information and instructions on how to use new elements.

What’s New (10/2015): CDF v1.3

  • New tags <MiniSeries> and <MiniSeriesEpisode> for use with episode-like content that does not belong to the <TVEpisode> type. Amazon considers episodes that belong to both a <TvSeason> and <TvShow> as valid <TVEpisode> types. <MiniSeriesEpisode> is used for sequential, episodic content that doesn’t belong to a <TvSeason>. <MiniSeriesEpisode> entries need to have an order and you must provide sequence numbers for those episodes.
  • New tag <TVSpecial> for non-sequential or one-off episodes that might or might not belong to a <TvShow>. Each <TVSpecial> entry requires an <OriginalAirDate>, which Amazon uses to order the <TVSpecial> in relation to other entries. A <TVSpecial> can be linked to a <TVShow> without also having to link to a <TVSeason>.
  • New tag <Extra> to include trailers and clips. Trailers and clips can be associated with other content.
  • The <ReleaseInfo> element, containing the <ReleaseDate> and <ReleaseCountry> elements, is now deprecated. The <ReleaseCountry> information is no longer used. The <ReleaseDate> information is now specific to each work type. <Movie>, <TvShow>, and <MiniSeries> have a new <ReleaseDate> element. <TvEpisode>, <TvSpecial>, and <MiniSeriesEpisode> use <OriginalAirDate>. <Extra> does not have release date information.

What’s New (5/27/2015) CDF v1.2

  • New tag <JP_Require18PlusAgeConfirmation> to indicate adult content in the Japanese marketplace.
  • New tag <Count> in RatingType to indicate the number of users who have contributed a rating.
  • The <Role> tag in ActorType is now optional.
  • The <Quality> element in each Offer type is now deprecated. Use the <Quality> element in <LaunchDetails> instead.
  • New tag <LaunchDetails> provides new content metadata that can be used by the Fire TV launcher, including <Quality>, <AudioLanguage> (for dubbed options), <Subtitle> (for alternate language subtitles), and <LaunchId> for a custom launch ID that includes these metadata.

Older Resources