@amazon-devices/kepler-channel

The @amazon-devices/kepler-channel package provides functionality that allows React Native for Kepler apps to handle channel tuning operations. This package supports channel changing and channel skipping functionality for TV applications built on the Kepler platform.

Get started

Setup

1. Add the following library dependency to the dependencies section of your package.json file.

1. In your manifest.toml, add the following privileges required to access the Kepler Channel fucntionality.

   Copy code Copied to clipboard.

    [components]
    ## Define your app's interactive component (if it doesn't already exist)
    [[components.interactive]]
    id = "<packageId>.main"
    runtime-module = "/com.amazon.kepler.keplerscript.runtime.loader_2@IKeplerScript_2_0"
    launch-type = "singleton"
    categories = ["com.amazon.category.main", "com.amazon.category.kepler.media"]
   
    [[extras]]
    ## `interface.provider` designates a component 
    ## that provides implementation of certain interfaces
    key = "interface.provider"
    ## Declares the component that provides the implementation of the interfaces.
    ## This component must be defined under [[components.interactive]] and includes
    ## "com.amazon.category.kepler.media" in its categories.
    component-id="<packageId>.main"
   
    [extras.value.application]
    ## Declare support for Kepler Channel
    [[extras.value.application.interface]]
    interface_name = "com.amazon.kepler.media.IChannelServer"
    features = ["ChannelList"]
   
    ## Hardcode ChannelList attribute to [] since we use Kepler EPG Provider to provide channel data
    [extras.value.application.interface.static-values]
    ChannelList = []
   

   Details about the two categories added for the main interactive component:

   • com.amazon.category.main declares the component as the default interactive component for the app package.
   • com.amazon.category.kepler.media declares the component to be targeted for Kepler Media operations.

Related topics

• Kepler Channel Integration

Modules

• Channel
• ChannelServer2
• ChannelServerComponent
• ChannelServerComponent2
• InternalTypes
• KeplerScriptChannel

---

Last updated: Sep 30, 2025