Skip to content

ADB

Only for Pro version

Available only in Pro version

USB debugging

Turn on "USB debugging" on your Android TV device to enable the features in this tab. Some devices also require to have enabled "Wireless debugging"

Check connection

If something from this tab is not working correctly, first of all, use the "Check connection" item from this tab to check if ADB has a connection.

Chromecast with Google TV + Android TV 14

If your device is Chromecast with Google TV with installed Android TV14, then it requires additional steps to get ADB working. You can find the detailed manual on YouTube

Turn on debugging

If you haven't enabled USB debugging yet, it will be the first item, and all others will be disabled and unavailable.

Use ADB for remap

Many devices have remote controls with app buttons implemented in a way that doesn't allow remapping these buttons. In this case, ADB can help you.

If you want to use ADB for remapping, you need to disable the app whose button you want to remap. This prevents the app from running on the device. If it is a system app, you can find "Disable" in the settings (Settings -> Apps -> Prime Video (for example) -> Disable). If it is not a pre-installed system app, you need to use the ADB command to disable it:

[adb shell] pm disable-user --user 0 com.amazon.amazonvideo.livingroom

com.amazon.amazonvideo.livingroom must be replaced with the package name of the app you want to disable

When you have disabled the app, try to remap the button

Remap using getevent

Sony TV only

This optional item is only visible on Sony TV.

This method of remapping is used when you have two or more buttons with the same keycode, so when you try to remap these buttons, you can remap two or more buttons as one.

Detailed tutorial on how to use and configure it: Reddit

Mix up Netflix and Prime

Sony TV only

This optional item is only visible on Sony TV. It depends on the previous setting.

tvQuickActions has pre-configured keys which are sent by the remote when you press Netflix and Prime Video buttons. These keys can be mixed up on different devices. If this causes trouble for you, you can enable this to fix it.

Use ADB for volume buttons fix

You can find the description of "Volume buttons fix" in Settings -> General. If the "Volume buttons fix" from Settings -> General doesn't work for you, you can try this fix. This method supports more devices but is not suitable for everyone due to ADB usage.

Use ADB for mouse

IMPORTANT

This is required to get mouse mode working on Android 11+

This allows you to fix mouse functionality for Android 11+ by using ADB to emulate clicks.

Use ADB for emulating buttons

If you want to use actions from the Keycode tab or dialpad, you need to have Leankey Keyboard installed or enable this option. It allows the use of ADB to emulate buttons

Use ADB speed up (experimental)

It allows you to speed up the previous two features - mouse and button emulation which work with some delay without it.

If you have trouble with the speed up feature, please write to tvdevv@gmail.com

Use ADB for killing apps

If you want to get the "Close all" button working properly in recent apps, you need to enable it. It's also used for actions like "Stop all recent apps", "Kill foreground app", etc.

Use ADB for some actions

You can find Reboot and Power Off actions in the "Action" tab or create ADB commands. This option must be enabled to get them working properly

Restart ADB service after sleep

This forces the service to restart after the device is turned on. This is necessary if the service stops working after turning it off and on.

Port

Some devices have a non-default port, so you can change it here. The service will not work with an incorrect port.

The default port is 5555.

Delay before running ADB service

This is needed for devices that have trouble with the ADB service after reboot but work after "Restart service" from this tab.

You can set a delay after which the service will be launched

Fix permissions

This is used when you need to grant permissions via ADB. You can do this directly from the app.

You can find the manual in the Troubleshooting section.

Check ADB connection

Here you can check the ADB connection. If it is working, then all features that use ADB should work. If it is not working, try to restart the ADB service in the next item.

Restart ADB service

Here you can restart the ADB service if you have any trouble with ADB features.

Automatic confirmation of ADB connection

Devices with Android 12+ can ask for confirmation very often, so to automate this process, you can enable it. But it will confirm any connection, so be careful - anyone will be able to connect to your device using ADB

Restore ADB Port

Tap here to automatically pair using a pairing code. It will open "Developer options", then you should enable "Wireless debugging" and select "Pair device with pairing code"

Restore ADB Port on Boot

This is required if your device uses "Wireless debugging" to keep ADB working after reboot.

IMPORTANT

It requires WRITE_SECURE_SETTINGS permission. Check "Fix permissions" on this page or the "Troubleshooting" page to get info on how to grant this permission

Automatically calculate FPS

Important

Requires enabled "Use ADB for speed up"

Special option for FPS calculation which can be used for AFR.

Calculation works correctly only if your current display mode is 60hz. It is impossible to display more frames than in the current display mode, so with other modes it is impossible to correctly count the number of frames

ADB speed up modes

ADB speed up server can work in different modes according to your needs:

  • Attached to main process - default mode
  • Independent from main process - keep server working when app was stopped
  • Independent + volume fix - best working volume buttons fix
  • Independent + Recover app after crash/kill - server will try to restore app if it was stopped or killed
  • Independent + All Features - this option includes volume buttons fix and recover app after crash/kill

IMPORTANT

This requires enabled "Use ADB speed up"

Custom getevent codes

Here you can map an action to a button if you use a custom remote control or if a button can't be remapped using the accessibility service

IMPORTANT

You need to find a way to intercept button presses. For example, if the button opens some app, you need to disable this app. If you can't intercept the button's default action, it will run both actions - the original and the custom one.