Home > Devices > Amazon Fire TV

Installing and Running Your Fire TV App


To test and debug your  Fire TV app before submitting it to the Amazon Appstore, use Eclipse or the Android Debug Bridge (ADB) to install it on your Fire TV device. This is sometimes referred to as "sideloading" an app. This document describes how to install, run, and uninstall your app on the device, with Eclipse and ADB on the command line.

You must have already used ADB to connect your development computer to your Fire TV device. See Connecting ADB over USB or Connecting USB over a Network for more information.

Note: Certain development tools and resources referenced on this page are provided by third parties, not by Amazon. Any links to these tools and resources will take you to third-party sites.

Installing and Running Your App (Eclipse)

Use the Eclipse IDE to both install and run your apps on Amazon Fire TV. To install and run your app with Eclipse, use the following steps:

  1. In the Eclipse package explorer, right-click your project.
  2. Click Run as, and then click Run Configurations.
  3. In the left navigation column, right-click Android Application.
  4. Click New to create a configuration.
  5. In the Name box, type a name for the new configuration.
  6. On the Android tab, next to the Project box, click Browse.
  7. Select the project for your app, and then click OK.
  8. On the Target tab, click Always prompt to pick device. This setting enables you to choose Amazon Fire TV each time you run your project.
  9. Click Run.
  10. Select the device where you want to install and run the app, and then click OK.

The run configuration you define is saved. The next time you run your project from Eclipse, after clicking Run as (Step 2), you can click Android Application to use that saved run configuration.

Installing Your App (Command Line)

To install your app onto your Fire TV device from the command line, use this command, where <path-to-apk-file> is the file system path to your app's APK:

adb install <path-to-apk-file>

If the installation was sucessful, ADB responds with the message similar to this one:
764 KB/s (217246 bytes in 0.277s)
pkg: /data/local/tmp/HelloWorld.apk

To re-install an app that already exists on the device, you can use the -r option to reinstall the app:

adb install -r <path-to-apk-file>

Note that reinstalling an app does not replace any existing additional user data or cache. If you want to clear this data, uninstall the old app before installing a new version, or clear the data by hand in System > Applications.

Running Your App (Device)

Sideloaded apps do not appear in the launcher. To run your app, use the following steps:

  1. From the main screen, select Settings > Applications.
  2. Select your app.
  3. Select Launch application.

Running Your App (Command Line)

To send a launch intent to your app on the Amazon Fire TV device, use this command, where com.amazon.sample.helloworld is the package name of your app, and MainActivity is the name of your app's primary activity.

adb shell am start -n com.amazon.sample.helloworld/.MainActivity

ADB responds with a message similar to this, and your app begins running:
Starting: Intent { cmp=com.amazon.sample.helloworld/.MainActivity }

Uninstalling Your App (Device)

To uninstall your app from Amazon Fire TV on the device itself, use the following steps:

  1. From the main screen, select Settings > Applications.
  2. Select your app.
  3. Select Uninstall > Uninstall.

Uninstalling Your App (Command Line)

To uninstall your app from the command line, you need the package name for your APK. Use this command to uninstall your app, where com.amazon.sample.helloworld is the package for your app.

adb uninstall com.amazon.sample.helloworld

If you are unsure of your app's package name, use this command to see a list of all the installed APKs and their package names:

adb shell pm list packages -f