Press a TV remote navigation, media, or hardware button
tv-remotePress or long-press buttons on Android TV, tvOS, or Vega OS remotes, including navigation, media, volume, and power keys. Use it to control TV apps during automated testing and debugging.
Instructions
Press or long-press a TV remote button on Android TV, tvOS, or Vega OS. Android TV also supports volume, power, media, channel, guide, captions, input, color keys, and android-keycode:N. tvOS and Vega OS support up, down, left, right, select, menu, home, and back. Phones and WebDriver sessions are unsupported. The aliases ok, center, and enter map to select. Times out after 90s.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"button": "<button>"
},
"name": "tv-remote"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| udid | No | Apple device or simulator UDID. | |
| button | Yes | TV remote button. Android TV also accepts android-keycode:<n> with n from 1 to 2147483647. | |
| device | No | Device name; ids go in udid or serial. | |
| serial | No | Android, HarmonyOS, or Vega VVD serial. | |
| session | No | Session name. | |
| noRecord | No | Do not record this action. | |
| platform | No | Device platform. | |
| durationMs | No | Press duration in milliseconds. tvOS and Vega OS use the exact hold duration; Android TV maps any positive value to an ADB longpress (longpress). | |
| deviceTarget | No | Device form factor. |