| name | samsung-tv |
| description | Control Samsung The Frame TV. Use when asked about TV, television, art mode, Samsung Frame, turning on/off the TV, or changing TV input/volume/apps. |
| allowed-tools | Bash(samsung-tv:*) |
| metadata | {"openclaw":{"emoji":"T","requires":{"bins":["samsung-tv"]}}} |
Samsung TV Control
Control Samsung The Frame TVs via the samsung-tv CLI. Uses WebSocket protocol (port 8002) over Tailscale subnet routing.
Available Commands
Show TV status
samsung-tv status
Power on/off
samsung-tv power <name> on
samsung-tv power <name> off
Volume / mute
samsung-tv volume <name> up
samsung-tv volume <name> down
samsung-tv volume <name> 5
samsung-tv volume <name> -5
samsung-tv mute <name>
Send remote key
samsung-tv key <name> KEY_HOME
samsung-tv key <name> KEY_SOURCE
samsung-tv key <name> KEY_HDMI1
samsung-tv key <name> KEY_HDMI2
samsung-tv key <name> KEY_RETURN
samsung-tv key <name> KEY_ENTER
samsung-tv key <name> KEY_UP
samsung-tv key <name> KEY_DOWN
samsung-tv key <name> KEY_LEFT
samsung-tv key <name> KEY_RIGHT
Apps
samsung-tv app <name> list
samsung-tv app <name> launch netflix
samsung-tv app <name> launch 3201907018807
samsung-tv app <name> close netflix
Art mode (Frame TV only)
samsung-tv art <name>
samsung-tv art <name> on
samsung-tv art <name> off
samsung-tv art <name> list
samsung-tv art <name> select <id>
TVs
Crosstown residence
- Samsung The Frame 65 — QN65LS03BAFXZA, 2022 (
192.168.165.2, MAC ${SAMSUNG_TV_MAC})
TV names are fuzzy-matched (e.g. "frame" for Samsung The Frame 65).
Known App IDs
Netflix, YouTube, Spotify, Disney+, Hulu, Prime Video, HBO Max / Max, Apple TV, Plex, Paramount+, Peacock, Tubi — all fuzzy-matched by name.
Network
TV is on the Crosstown LAN (192.168.165.0/24). The Mac Mini reaches it via Tailscale subnet routing through dylans-mac (must be awake at Crosstown).
Wake-on-LAN limitation: WoL uses broadcast packets which don't traverse Tailscale subnet routing. Power-on only works from dylans-mac (same LAN). Power-off works from anywhere via WebSocket.
TV config is in ~/.openclaw/samsung-tvs.json. Auth tokens are cached at ~/.cache/samsung-tv/<name>/token.txt.
Notes
- Always run
samsung-tv status first to check if the TV is reachable and powered on
- First connection to a new TV requires physical "Allow" on the TV remote
- Art mode commands only work on Samsung The Frame models
- Volume uses remote key simulation (KEY_VOLUP/KEY_VOLDOWN) — there's no direct volume API
- If TV shows UNREACHABLE, the subnet router (
dylans-mac) may be asleep or offline