Developer Tool Options (Amazon Fire TV)
The Developer Tools Menu provides a number of options that provide real-time metrics and other information about your app. This information can assist you in troubleshooting, development, and testing.
- Invoke the Developer Tools Menu
- System X-Ray
- Advanced Options
- Record & Share
- Developer Options
- Launch Network Advisor
- See Also
Invoke the Developer Tools Menu
You can invoke the Developer Tools menu in several ways:
- Remote Control: On the directional pad, press and hold the center and down together (simultaneously) for 5 seconds; then release the buttons and press the remote’s menu button.
- Amazon Game Controller: Press and hold A and Y buttons together (simultaneously) for 5 seconds; then release the buttons and press the controller’s menu button.
- If ADB is enabled on the Fire TV and a computer is connected, you can run the following command to invoke the dialog box:
adb shell am start com.amazon.ssm/com.amazon.ssm.ControlPanel
The following screenshot shows the options on the Developer Tools menu:
System X-Ray gathers instantaneous system metrics and displays on top of the screen as an overlay. When toggled on, the overlay will always be visible on the screen.
The System X-Ray overlay contains details about the following:
For deep-dive into System X-Ray, see System X-Ray.
Advanced Options enables multimedia information to appear when Android MediaCodec APIs are in use. When you switch this option on and then play media, an additional display (titled “MUL” for Multimedia (audio and video) and “AUD” for Audio Focus) appears on the right.
Information displayed in the Multimedia panel is divided into three sections: Audio, Video, and Audio Focus.
|Codec||Audio codec format|
|Hardware Accelerated||If audio playback is hardware accelerated|
|Input Bitrate||Audio input bitrate|
|Secure||If secure or not|
|Codec||Video Codec Format|
|Hardware Accelerated||If video playback is hardware accelerated|
|Input Bitrate||Video Input Bitrate|
|Secure||If video secure or not|
|Frames Dropped||Frame drop count|
|Frame Rate||Playback frame rate|
|Package||Package name of the audio playback|
|Gain||Audio focus gain implication|
|Loss||Audio focus loss implication|
|F/U/C||Flag / Usage / Content|
Audio Focus values are shortened as following:
Snapshot provides a way for users to gather instantaneous all metrics information through
adb command. Whenever you input the following command, metric information will display in the command line.
adb shell dumpsys activity service com.amazon.ssm/.OverlayService
System X-Ray must be running for this command to function.
Here’s a sample output:
SERVICE com.amazon.ssm/.OverlayService 3dde6680 pid=10820 Client: [com.amazon.ssm.timestamp]: [2017-02-07 15:11:53] [com.amazon.ssm.display.resolution]:  [com.amazon.ssm.display.refreshrate]:  [com.amazon.ssm.display.hdcpversion]: [1.0] [com.amazon.ssm.cpu.core0]:  [com.amazon.ssm.cpu.core1]:  [com.amazon.ssm.cpu.core2]:  [com.amazon.ssm.cpu.core3]:  [com.amazon.ssm.memory.appname]: [tv.twitch.android.viewer] [com.amazon.ssm.memory.appmemory]: [56.8 MB] [com.amazon.ssm.memory.activememory]: [1.3 GB] [com.amazon.ssm.memory.availablememory]: [231.3 MB] [com.amazon.ssm.network.rssi]: [-56] [com.amazon.ssm.network.systemdownloadspeed]: [2.2 Mbps] [com.amazon.ssm.network.appdownloadspeed]: [2.1 Mbps]
Record & Share
Record & Share stores instantaneous metrics about CPU, memory, network, and multimedia into a database as historical data. Although the same information is displayed graphically in real-time through the System X-Ray overlay, Record & Share takes this information and stores it into a history that you can dump to the command line.
To use Record & Share, first toggle the Record & Share setting in the Developer Tools Menu to On. You’re then prompted to select the Record Settings:
These properties control the following:
- Interval: The time between two recordings: 2 seconds, 4 seconds, 8 seconds, 16 seconds, or 32 seconds.
- Duration: How long the data gets stored in the database: 1 hour, 2 hours, 4 hours, 8 hours, or 16 hours.
The default (2s interval, 1 hr duration) means that every 2 seconds, statistics will be recorded and stored in the database. The recording will be stored in the database for a total of 1 hour.
After playing media to gather some recorded information, you can dump all historical metrics to the command line using the following::
adb shell dumpsys activity service com.amazon.ssm/.OverlayService -all
The response includes the following information:
Here’s an example of the display on the command line:
CPU Timestamp cpu0 cpu1 cpu2 cpu3 2016-10-31 11:40:22 19 16 13 18 MEMORY Timestamp Total_Memory Available_Memory Active_Memory Foreground_App_Memory Foreground_App_PackageName 2016-10-31 11:40:23 919.3 MB 156.3 MB 731.8 MB 31.3 MB com.amazon.ssm NETWORK Timestamp RSSI Download_Speed Foreground_App_Download_Speed Foreground_App_PackageName 2016-10-31 11:40:21 -41 14.4 kbps 0 bps com.amazon.ssm 2016-10-31 11:40:23 -41 14.0 kbps 0 bps com.amazon.ssm
If you’re interested in only part of the metrics, you can add different options in the command. For example, to dump memory and network historical metrics to command line:
adb shell dumpsys activity service com.amazon.ssm/.OverlayService -memory -network
The following table shows all available options:
(no option passed)
|dump snapshot information|
||dump snapshot information|
||dump all information from database|
||dump memory information from database|
||dump CPU information from database|
||dump network information from database|
||dump multimedia information from database|
To check available options, pass the
adb shell dumpsys activity service com.amazon.ssm/.OverlayService -help
You can clear the recorded metrics stored in the database (before the duration time automatically clears the data). From the Developer Options Tools menu, select Record & Share, and then click the menu button on your remote.
Some TVs use overscan with their display. Overscan means the TV displays some information off the edges of the visible screen (to accommodate discrepancies in monitors). You should not display important information in the overscan areas.
To make the overscan areas visible, you can turn the SafeZone switch to On. This will make the overscan areas apparent so you can avoid displaying any information in these areas.
Note that Fire TV Stick (Gen 2) does not include screen size calibration. If the screen display doesn’t fit correctly on the TV screen, the overscan area may not show accurately.
Currently, some third-party apps, such as Netflix and HBO Go, display recommendations on the Amazon Fire TV home screen in specific rows. For more information on recommendations, see Recommendations Overview.
Developer Options allows you to turn on a row called “Recommended By Your Apps” (displayed below the Netlix and HBO Go rows). This “Recommended By Your Apps” row will show recommendations sent from third-party apps.
Turning this row shows recommendations from all third-party apps the user has installed (excluding some apps such as Netflix and HBO Go, which display recommendations on their own rows).
Launch Network Advisor
Launches a network analysis window that checks your network connection strength, channel, and other details. If there are problems, the Network Advisor provides recommendations to fix the issues.
For more details, see the following: