ScreenSplice setupMenus & slideshowsLive captureFire TV controlWebsite

Fire TV control

What we can offer

On a compatible, configured Fire OS device, ScreenSplice can send Home, Back, directional navigation, Select, Play and Pause, and can request launch of a locally approved installed app. An optional YouTube deep link can request a video ID through a locally configured app. A delivered command is not proof that a streaming app started a particular title.

The USB capture card is the video path. Control uses a separate connection:

Dashboard → authenticated ScreenSplice service → paired Pi → trusted venue network → authorized Fire TV

No inbound internet access or port forwarding to ADB is required. Do not expose Fire TV debugging to the public internet.

Check the operating system first

  1. On the Fire TV open Settings → My Fire TV (or Device & Software) → About.
  2. Record the exact model, generation and operating system version.
  3. If it runs Android-based Fire OS and offers ADB debugging, it is a candidate for this pilot.
  4. If it runs Vega OS, stop this ADB setup. Amazon documents Vega Device Adapter (VDA) separately. The current pilot does not implement or validate VDA control.
  5. Before purchasing another stick, check the exact model/OS rather than relying only on the words “Fire TV” or “4K.”

Connect and use the remote

  1. Complete the live-capture guide first and confirm an unprotected source picture.
  2. Put the Pi and Fire TV on the same trusted venue network. Isolated guest Wi-Fi will prevent a local connection.
  3. On a compatible Fire OS device enable Developer Options → ADB Debugging using Amazon’s instructions. If the menu is hidden, follow the steps for your exact model in the official guide.
  4. Ask the installer/administrator to install ADB on the Pi and configure the local opt-in described below. The dashboard cannot choose an arbitrary network target.
  5. Start a two-minute control session from the device page in ScreenSplice. Initial contact can take up to one normal check-in minute.
  6. Watch the Fire TV screen for the ADB authorization prompt. Approve only the Pi you own/manage. Keep the physical Fire TV remote available for this first approval.
  7. Wait for the dashboard to report an authorized connection for the current session. Remote buttons remain disabled until then.
  8. Choose one of the locally approved installed apps and Open app, or navigate with the dashboard’s remote buttons.
  9. Use Play/Pause as supported by the running app. To request a specific YouTube video, the administrator must configure the actual installed YouTube package and you must enter a valid 11-character video ID.
  10. End the control session when finished. Queued commands expire quickly and are not replayed after a long outage. Start a new session for later changes.

Fire TV control requires installer setup and authorization on the Fire TV. It is not enabled by plugging in a capture card. Menus and slideshows do not need Fire TV control.

Installer setup and approved apps

The installer must enable the local connection and approved apps. Use the current ScreenSplice OS from Downloads; an old image version number is not a setup requirement.

Saved Play on Fire TV presets

  1. Have the installer test an HTTPS content link with its specific installed app. Supporting app launch does not automatically mean the app supports a specific show or channel link.
  2. The installer adds a content entry to the private local configuration. Each entry has a short ID, label, approved package and HTTPS URL. URLs and network targets are never supplied by dashboard commands.
  3. Example local content entry: content={"morning":{"label":"Morning program","package":"actual.installed.package","url":"https://example.com/replace-with-a-supported-content-link"}}. This is an illustrative shape, not a working app integration.
  4. Start an authorized control session so the Pi reports its approved content list. On the device page choose Approved content, enter a preset name and Save content preset.
  5. In an active session press Play on Fire TV next to the saved preset. Wait for the command status, then verify the program on the display. Sent means delivery, not confirmed playback.
  6. Delete presets you no longer need. If the installer removes a local link or its app, the old preset cannot launch it. Up to 50 saved presets and 50 locally approved links are supported per screen.

Presets are manual launch shortcuts. Scheduled streaming launches, unsupported apps and custom URL schemes remain separate compatibility work. Keep app login and parental/content controls in the app.

Limits

Official references

Amazon Fire OS ADB connection: https://developer.amazon.com/docs/fire-tv/connecting-adb-to-device.html

Amazon app-launch intent testing: https://developer.amazon.com/docs/catalog/test-launcher-integration-with-adb.html

Amazon Vega network development connection: https://developer.amazon.com/docs/vega/0.22/vda-over-tcpip

Android remote/media key definitions: https://developer.android.com/reference/android/view/KeyEvent