Sky Stream

Controls a Sky Stream or Sky Glass box over IP using Sky's native RICS protocol (mutual-TLS WebSocket on TCP 8091). No IR emitter, no cloud, no Sky account required — the driver talks to the box directly on the LAN, like the official Sky mobile remote. By Macrohat.

Requirements

Sky Stream or Sky Glass on the same network the Control4 controller can reach (TCP to the box on port 8091; UDP broadcast for Wake-on-LAN).
The box's Wake-on-LAN must be enabled (default on Sky Stream) for waking from standby.

Installation

Add the driver to the project and bind its video output as you would any AV source.
Set the box address: either type it into Sky IP, or run Discover Boxes (Actions tab) and pick the box from the Discovered Boxes list — that auto-fills Sky IP and Sky MAC.
Optionally set Remote Name (how the driver appears in the box's paired-remotes list).
Confirm Connection Status reaches Connected after selecting the source.

Sky MAC is required for reliable power-on. It is filled automatically by Discover Boxes; if you type the IP by hand, also set Sky MAC so the driver can wake the box from deep sleep.

Properties

Property	Description
Discovered Boxes	Boxes found by Discover Boxes; selecting one fills Sky IP and Sky MAC.
Sky IP	The box's IP address.
Sky MAC	The box's MAC address (for Wake-on-LAN). Auto-filled by discovery.
Connection Status	Current state (see the table below).
Device ID	The box MAC, shown once known.
Remote Name	Name the driver presents to the box at pairing (shown on the box's paired-remotes list). Default Control4.
Allow Power Off	If On, the OFF/room-off action sends Power to put the box in standby. Default Off.
Power On Key	The key sent after connecting to bring the picture up when starting to watch. Default Home. Change if you prefer a different landing.
Keep Alive Seconds	Interval for the session keepalive. Default 30.
Queue Speed Milliseconds	Minimum gap between commands sent to the box. Default 300.
Power On Timer	Seconds to spend waking the box (Wake-on-LAN) before giving up. Default 10.
Keep Awake While Selected	Experimental. If On, while the room has Sky selected the driver periodically nudges the box to stop it sleeping the picture on the idle home screen (see below). Default Off.
Debug Mode	Enables verbose logging in the Lua tab. Default Off.

Home-screen sleep: left on the Sky home screen with nothing playing, the box sleeps its picture after a while (it treats it as "no one watching") even if the room is still selected — a returning viewer then sees the room on but a blank box. Playing a channel/app keeps it awake. Keep Awake While Selected is an experimental option to hold it awake while selected.

Connection Status values

Status	Meaning
Idle	Driver loaded; no box activity yet.
Waking box...	Connecting: Wake-on-LAN sent, pairing/binding in progress.
Scanning for boxes...	Discovery is running.
Found N box(es) - pick one	Discovery finished; choose one in Discovered Boxes.
No boxes found	Discovery finished with no responses.
Box did not respond (asleep?)	Could not connect within the wake window.
Paired: <name>	Pairing succeeded (momentary, just before binding).
Connected	Bound and ready — commands will work.
Pair rejected	The box refused pairing.
Box busy - cooling down	The box rejected a bind (busy/locked); the driver backs off for 90s to let it recover.
Box busy - wait a moment	A command arrived during the cool-down and was deferred to protect the box.
Offline	The session dropped; the next command reconnects.

Actions

Discover Boxes — scan the network and populate Discovered Boxes.
Connect / Disconnect — establish or drop the session manually.
Import TV Channels — reserved (not yet implemented).
Display Diagnostics — print the driver's current state and settings to the Lua tab for support.

Programming

Use the Press Button device-specific command and choose any Sky key from the list to send it (all navigation, transport, colour, digit, volume and power keys are available).

How power / watch works

Selecting the source connects to the box and, if it was in standby, sends the Power On Key to bring the picture up (the box needs a key press after waking). Waking from deep sleep uses a Wake-on-LAN burst and can take a few seconds. If the box is already in use, the driver does not re-send the wake key.

Troubleshooting

Connects but no picture: ensure Power On Key is set (default Home); the box shows video only after a key press following a wake.
Won't wake from standby: confirm Sky MAC is set and the box's Wake-on-LAN is enabled.
"Box busy": the box is recovering; wait ~90 seconds (a box power-cycle also clears it).
Enable Debug Mode to see detailed activity in the Lua tab.

The driver ships a Sky client certificate that expires 2027-04-30; a driver update will be required to continue after that date.