🧰 Commands

`gtv`

Open the fullscreen TUI remote. Pairs on first run.

$ gtv

Pair with a Google TV on your local network. Launches mDNS discovery and prompts you to select a device.

$ gtv pair
$ gtv unpair

Discover Google TV devices on the local network via mDNS.

$ gtv discover           # list discovered devices
$ gtv discover --select  # discover and interactively select one to pair

Switch the active device. Without an argument, shows an interactive picker.

$ gtv switch             # interactive picker
$ gtv switch living-room # switch by name

List all paired devices and show which one is active.

$ gtv devices

Show connection status for the active device.

$ gtv status

Run a health check on the active device connection.

$ gtv doctor

Send individual navigation key presses without opening the TUI.

$ gtv home
$ gtv back
$ gtv up
$ gtv down
$ gtv left
$ gtv right
$ gtv select

$ gtv vol up
$ gtv vol down
$ gtv vol mute

Send any Android TV key by name.

$ gtv key KEYCODE_POWER
$ gtv key KEYCODE_MEDIA_PLAY_PAUSE

Deep-link launch an app by URL.

$ gtv app https://www.netflix.com/
$ gtv app https://www.youtube.com/