Skip to content

Samsung TV (Tizen)

Controls Samsung Tizen TVs (2016 and later) for navigation, inputs, transport, and remote keys. It connects over the TV’s remote-control WebSocket.

Network, over WebSocket: secure wss on port 8002, or plain ws on port 8001. The first connection triggers a pairing prompt on the TV; accepting it yields a token, stored as a managed secret.

Power-on is handled by Wake-on-LAN, which needs the TV’s MAC address — taken from the TV itself where it can be. Power state is read back over the TV’s REST interface.

  • Host — the TV’s address.
  • MAC address — needed for Wake-on-LAN power-on, and usually filled in automatically. A set on Wi-Fi publishes its own address in the REST document the driver already reads. A set on a cable does not — it still reports only its Wi-Fi card, which is the wrong one to wake — so for those the address comes from the hub’s own neighbour table instead, and only when the TV shares a network with the hub. A MAC you type is never overwritten.
  • Pairing — run pair_begin, then accept the prompt on the TV to obtain the token.
CommandWhat it does
pair_beginStart pairing (accept the prompt on the TV)
power_on (WoL) / power_off / powerPower the TV on or off
volume_up / volume_down / muteAdjust or mute volume
channel_up / channel_downChange channel
navNavigate the on-screen interface
menu / guide / info / exit / toolsOn-screen shortcuts
source / input_hdmi1input_hdmi4 / input_tvSelect an input
transportPlay, pause, and related transport control
red / green / yellow / blueColour keys
send_keySend a raw KEY_* code (e.g. KEY_NETFLIX)

Reports state and implements input-source discovery, so it exposes the TV’s real input list. It ships a remote template.