Mappings¶

Mappings is a screen with a list of remapped buttons and an option to remap a new button. You can also see whether a mapping is disabled or has constraints.

Long-press a mapping for quick options: duplicate it, delete it, or save it to a backup.

Use "Add button" at the bottom of the page to remap a button.

Current button¶

When you open a mapping, the first field shows which button is being remapped. You can change the remapped button by pressing "Current button" while keeping all other settings.

Button action type¶

There are three remapping types in the app: usual action, tvQuickActions panel, and button emulation. The default type is "tvQuickActions panel".

Usual action¶

The "Usual action" type allows you to set actions for single, double, and long presses of the remapped button.

tvQuickActions panel¶

If you use the tvQuickActions panel type, you can set 5 actions for each D-pad direction (up, left, down, right) plus OK.

Then, when you press the remapped button, you will see the tvQuickActions panel with your selected actions. Press up, left, down, right, or OK to run the action you need.

Button Emulation¶

If you use the 'button emulation' type, you can change the default action to one of your choice, for example sending the 'home' event instead of the original 'mute' key.

Constraints¶

You can set restrictions so that remapping works based on the foreground app, remote control, or playback state in a selected app. You can do this in Constraints. Open Constraints, then press Add to add a restriction.

App/activity in foreground/background¶

Choose whether the app must be in the foreground or background, then select the app. In this example, remapping works only when the Google TV launcher is in the foreground.

Remote control¶

Use this if you have several remote controls and want actions to depend on which remote is being used.

Playback state¶

You can also map actions based on playback state. For example, a mapping can work only when a video is playing in YouTube.

HDMI state¶

You can also create mappings based on the HDMI state. For example, in this case, we selected HDMI 1 and chose 'Connected', so the mapping will only work when these conditions are met.

Enabled¶

You can disable a remapping instead of deleting it when you don't need it.

Label¶

You can add a custom label to a button if it has a non-descriptive name in the app, or for any other reason. This label is also used to sort buttons on the "Mappings" screen.

Icon¶

The icon option is related to the new 'Toggle mappings' function. It is only used as a visual aid to make this action easier to recognize in places where it may be used, such as menus.