Google TV Control Driver v1.54

Smart Home Programming

Overview

This driver controls Google TV and Android TV devices over ADB via TCP/IP. Full two-way feedback – currently-focused app, media title/artist/artwork, transport state, screen on/off, volume, keyboard detection, Cast speaker discovery, and scene triggers.

Web Object UI

The driver includes a rich Web Object UI for RTI touchpanels with D-pad navigation, transport controls, app launcher grid, keyboard input, voice search, and now-playing display with album art.

URL format (v1.38+):

https://shpdrivers.services/googletv/?mac=<PROCESSOR_MAC>_<DEVICE_IP>

Where:

<PROCESSOR_MAC> – 12-char processor MAC, no colons (e.g. 0015260AEC70). Find it in Integration Designer under the processor's properties, or on the sticker underneath.

<DEVICE_IP> – the IP address of the Google TV / Android TV device (same value you entered in the driver's "Device IP" setting).

Example (one driver, Google TV at 192.168.1.100):

https://shpdrivers.services/googletv/?mac=0015260AEC70_192.168.1.100

Multiple driver instances:

Each driver instance on the same processor needs its OWN Web Object URL, using that instance's device IP. Example with three drivers at .100, .101, .102:

Driver 1: https://shpdrivers.services/googletv/?mac=0015260AEC70_192.168.1.100

Driver 2: https://shpdrivers.services/googletv/?mac=0015260AEC70_192.168.1.101

Driver 3: https://shpdrivers.services/googletv/?mac=0015260AEC70_192.168.1.102

Without this, multiple drivers on one processor all push state to the same endpoint and the Web Object flips between devices.

System Variables

Every piece of feedback is exposed as a System Variable in Integration Designer – bind them to labels, use them in macro conditions, or watch them for scene automation.

Connection:

Connected, Authorised, ConnectionStatus

Now playing / state:

CurrentApp – package name (e.g. com.netflix.ninja)

CurrentAppName – friendly label ("Netflix")

CurrentAppIcon – image URL for the now-playing app

NowPlayingTitle, NowPlayingArtist, NowPlayingAlbum, NowPlayingArt

MediaState – Playing / Paused / Stopped, plus booleans IsPlaying, IsPaused, IsStopped

ScreenState – boolean, true when screen is on

Volume, Muted

Events (macro triggers):

CONNECTED, DISCONNECTED, AUTH_REQUIRED

APP_CHANGED, SCREEN_ON, SCREEN_OFF

MEDIA_PLAYING, MEDIA_PAUSED, MEDIA_STOPPED, VOLUME_CHANGED

SCENE_APP_1_OPEN ... SCENE_APP_8_OPEN and _CLOSE versions

Setup

Step 1: Enable ADB over network

Settings > System > About > "Android TV OS build" (tap 7 times to enable Developer Mode)

Settings > System > Developer options

Enable "USB debugging"

Step 2: Find the device IP

Settings > Network & Internet > select your connection

Static IP reservation on your router is recommended so it doesn't change

Step 3: Configure the driver

Enter the device IP in the "Device IP" setting

Leave ADB Port at 5555 (default)

Step 4: Authorise the connection

On first connect the device will show "Allow USB debugging from this computer?" – tick "Always allow" and hit OK

The driver handles re-authorisation automatically if the device ever loses the key

Browse Menu

The browse menu exposes on-panel navigation lists for:

Apps – view and launch installed apps, force stop, clear data

Quick Actions – Play/Pause, Sleep, Wake, Volume, Home, Back

Inputs – HDMI 1-4, Input Cycle, Live TV

Settings – Wi-Fi, Bluetooth, Display, Sound, About

System – Sleep, Reboot, Device Info

Each menu section can be enabled or disabled in the driver configuration. Individual menus are also callable directly via Browse Apps, Browse Controls, Browse Inputs, Browse Settings, Browse System functions.

Scene Triggers

Automatically run macros when specific apps open or close. Up to 8 scene slots. In driver config, pick an app per slot; on the Events tab you'll get SCENE_APP_N_OPEN and SCENE_APP_N_CLOSE events per slot.

Volume

The Google TV Streamer has a volume range of 0-15 (0-7 on some devices – driver auto-detects at startup). Uses repeated keyevent presses to set absolute volume levels; direct set-volume isn't reliable on Google TV Streamer.

IMPORTANT: Volume control must be enabled on the Google TV Streamer:

Go to Settings > Display & Sound > Sound

Ensure volume control is set to the Google TV Streamer (not TV or AVR)

Debug Console

Connect via telnet to port 12509 on the RTI processor for live debugging:

telnet <processor-ip> 12509

Useful commands: status, shell <cmd>, key <code>, apps, media, vol, launch <pkg>, reboot, help for the full list.

Troubleshooting

"Auth Required" event fires repeatedly – check the device screen for the USB debugging authorisation prompt and accept it with "Always allow".

Cannot connect – verify ADB debugging is enabled, IP address is correct, port 5555 is reachable. A static IP reservation on your router helps.

Apps list is empty – takes a few seconds after connecting. Tapping the Apps tab in the Web Object triggers an auto-refresh.

Volume wrong – auto-detected at startup. Reconnect to re-detect if it shows wrong values.

Licensing

Licence keys can be purchased from the Smart Home Programming Driver Store. A 120-minute trial runs automatically so you can verify compatibility before buying.

Store: https://shpdrivers.services/store/

Email: david@smarthomeprogramming.com.au

Support

For bug reports, technical support, or feature requests, please use the ticket system in your account at the Driver Store.

Terms of Service

All drivers are provided "as is" without warranty of any kind. You use this software at your own risk. A free trial is included so you can verify compatibility with your system before purchasing – do not purchase a licence if you have not tested the driver on your hardware. Full terms: https://smarthomeprogramming.com.au/store/terms.html

Copyright 2026 Smart Home Programming. All rights reserved.