Overview of EPG Integration
Here’s what you need to know to integrate the Vega Electronic Programming Guide (EPG) Provider into your app for Fire TV. The Vega EPG Provider interface enables you to push the customer’s channel entitlements, program, live event, and metadata to the system so it can enable the browse and search experience for your content on Fire TV.
Prerequisites
- You are allowlisted for Live TV. Reach out to your Amazon contact to be allowlisted.
- Access to the source code of your app for Fire TV.
- A Fire TV device that supports this integration. Check with your Amazon contact for a list of device types currently supported.
- Although not mandatory, we prefer your catalog to be integrated with a cloud service such as Amazon Catalog Service or Gracenote. Check with your Amazon contact for help onboarding onto these services.
Integration steps
At a high-level, your app must implement the following:
- Include the necessary package dependencies in your app.
- Declare the EPG Sync Task in your manifest file.
- Define your EPG Sync Task with a basic implementation of EPG Ingestion. The logic can be broken up into three parts:
- Channel lineup ingestion.
- Program lineup ingestion. The Program Lineup Ingestion is only necessary if you don’t have a cloud-based catalog, such as Amazon Catalog Service or Gracenote.
- Live event ingestion. Live Event Ingestion is only necessary if you offer live events.
- Implement EPG Sync Task, following the best practices to add your EPG Ingestion logic.
- Schedule EPG Sync Task, following the best practices.
- Schedule repeating EPG Sync tasks on app install and updates.
- Schedule repeating EPG Sync tasks on entitlement changes.
- Register your task entry point with the system.
- Enable channel tuning and playback.
Last updated: Sep 30, 2025