This tool implements the remote control protocol for Android TV and Google TV.
The v1 is for the old Android TV Remote Control app
The v2 is for the newer Google TV app used when your android tv's remote services version is >= 5
The anymote protocol (old protocol for google tv < 2014) is not supported.
Check on your android tv device the Remote Services version (in Settings > Apps > See all apps > Android TV Remote Service).
If the version is >= 5, you sould use the v2 protocol.
First, start the pairing process ./atvremote -ip="192.168.1.20" -version=2 -pair
Then, you can send a list of keypress like this (this sould open the settings) ./atvremote -ip="192.168.1.20" -version=2 command="HOME;HOME;UP;RIGHT;RIGHT;ENTER
You can use this project as a library (see the godoc page) or directly in cli (see the releases page). In CLI mode, you must at least specify the IP to your android tv box. Here is the list of the supported flags:
| Name | Required | Default | Description | Example |
|---|---|---|---|---|
| pair | No | False | Pairing mode (if not specified the tool will start in command mode and assume that the pairing have already been done) | -pair |
| ip | Yes | None | IP or hostname of your android tv device | -ip="192.168.1.20" |
| cert | No | ./cert.pem |
Path to your certificate file (will be created in pairing mode) | -cert="./cert.pem" |
| key | No | ./key.pem |
Path to your private key file (will be created in pairing mode) | -key="./key.pem" |
| version | No | 1 |
Protocol version | -version=1 |
| command | No | None | List of keypress to emulate (see below) | -command="HOME;HOME;UP;RIGHT;RIGHT;ENTER" |
| open | No | None | Open an app using an intent (V1 Only) | -open="com.netflix.ninja/.MainActivity" |
| link | No | None | Open a link (V2 Only) | -open="https://netflix.com/title/" |
| info | No | None | Print a json object of the device's infos (V2 Only) | -info |
KEYCODE_ and separated with semicolons. There are some shortcuts for the most common keys (UP, DOWN, LEFT, RIGHT, HOME, BACK, VOLP, VOLM, MUTE, PWR, ENTER).
For examle this string a;UP;bc;KEYCODE_TV_INPUT_HDMI_1 will be parsed as [RemoteKeyCode_KEYCODE_A, RemoteKeyCode_KEYCODE_DPAD_UP, RemoteKeyCode_KEYCODE_B, RemoteKeyCode_KEYCODE_C, KEYCODE_TV_INPUT_HDMI_1] (see pkg/common/parsekey.go for more info).yourpackagename/.activityname.This project wouldn't have been possible without these awesome projects which reverse-engineered these protocols.