Roku Control

Run it on Hostinger →up to 70% off + an extra 10% with code ZACAARON10 Free API →

Installation

clawhub install imaloney/roku-control

Summary

Control Roku devices over your local network using the External Control Protocol (ECP). No authentication, cloud services, or complex setup required - just local HTTP commands.

SKILL.md

Roku Control

Control Roku devices over your local network using the External Control Protocol (ECP). No authentication, cloud services, or complex setup required - just local HTTP commands.

Prerequisites

Roku device on the same network as OpenClaw
Roku's IP address (can be discovered automatically)

Setup (First Time)

1. Discover your Roku:

bash

python3 scripts/roku_control.py discover

This will show all Roku devices on your network with their IP addresses.

2. Save the IP address:

Note your Roku's IP (e.g., 192.168.1.100) for use in commands.

3. Test connectivity:

bash

python3 scripts/roku_control.py --ip 192.168.1.100 info

Common Operations

Device Information

bash

# Get device details
python3 scripts/roku_control.py --ip 192.168.1.100 info

# List all installed apps
python3 scripts/roku_control.py --ip 192.168.1.100 apps

# See what's currently playing
python3 scripts/roku_control.py --ip 192.168.1.100 active

Navigation & Control

bash

# Navigate menus
python3 scripts/roku_control.py --ip 192.168.1.100 key Up
python3 scripts/roku_control.py --ip 192.168.1.100 key Down
python3 scripts/roku_control.py --ip 192.168.1.100 key Left
python3 scripts/roku_control.py --ip 192.168.1.100 key Right
python3 scripts/roku_control.py --ip 192.168.1.100 key Select

# Go home
python3 scripts/roku_control.py --ip 192.168.1.100 key Home

# Go back
python3 scripts/roku_control.py --ip 192.168.1.100 key Back

Playback

bash

# Play/pause
python3 scripts/roku_control.py --ip 192.168.1.100 key Play
python3 scripts/roku_control.py --ip 192.168.1.100 key Pause

# Rewind/fast forward
python3 scripts/roku_control.py --ip 192.168.1.100 key Rev
python3 scripts/roku_control.py --ip 192.168.1.100 key Fwd

# Instant replay (back 10 seconds)
python3 scripts/roku_control.py --ip 192.168.1.100 key InstantReplay

Volume & Power

bash

# Volume control (Roku TV or HDMI-CEC enabled)
python3 scripts/roku_control.py --ip 192.168.1.100 key VolumeUp
python3 scripts/roku_control.py --ip 192.168.1.100 key VolumeDown
python3 scripts/roku_control.py --ip 192.168.1.100 key VolumeMute

# Power off
python3 scripts/roku_control.py --ip 192.168.1.100 key PowerOff

Launch Apps

bash

# Launch by app ID (faster)
python3 scripts/roku_control.py --ip 192.168.1.100 launch 12  # Netflix

# Launch by app name (case-insensitive)
python3 scripts/roku_control.py --ip 192.168.1.100 launch Netflix
python3 scripts/roku_control.py --ip 192.168.1.100 launch YouTube
python3 scripts/roku_control.py --ip 192.168.1.100 launch "Disney+"

Search & Text Input

bash

# Send search text
python3 scripts/roku_control.py --ip 192.168.1.100 text "Breaking Bad"

# This is much faster than individual key presses for searches

Natural Language Translation

Map user requests to commands:

Navigation:

"Go to home screen" → key Home
"Go back" → key Back
"Scroll down" / "Move down" → key Down
"Select this" / "Click" → key Select

Playback:

"Play" / "Resume" → key Play
"Pause" → key Pause
"Rewind" → key Rev
"Fast forward" → key Fwd
"Go back 10 seconds" / "Replay that" → key InstantReplay

Volume:

"Turn up the volume" → key VolumeUp
"Turn down the volume" → key VolumeDown
"Mute" / "Unmute" → key VolumeMute

Apps:

"Open Netflix" → launch Netflix
"Launch YouTube" → launch YouTube
"Start Hulu" → launch Hulu

Search:

"Search for Breaking Bad" → text "Breaking Bad"
"Find Stranger Things" → Open search + send text

Power:

"Turn off the TV" → key PowerOff

Common App IDs

See references/common-apps.md for a comprehensive list.

Quick reference:

Netflix: 12
YouTube: 837
Hulu: 2285
Disney+: 291097
Amazon Prime Video: 13
HBO Max: 61322
The Roku Channel: 151908

To get app IDs for your specific Roku:

bash

python3 scripts/roku_control.py --ip <ip> apps

Complete Key Reference

See references/remote-keys.md for all supported remote keys.

Common keys: Home, Back, Up, Down, Left, Right, Select, Play, Pause, Rev, Fwd, VolumeUp, VolumeDown, VolumeMute, PowerOff, Search, Info

Advanced Workflows

Watch Netflix

bash

# Go home, launch Netflix
python3 scripts/roku_control.py --ip 192.168.1.100 key Home
sleep 1
python3 scripts/roku_control.py --ip 192.168.1.100 launch 12

Search and Play

bash

# Open search, send text, select first result
python3 scripts/roku_control.py --ip 192.168.1.100 key Search
sleep 1
python3 scripts/roku_control.py --ip 192.168.1.100 text "The Office"
sleep 1
python3 scripts/roku_control.py --ip 192.168.1.100 key Select

Quick Replay

bash

# Go back 10 seconds and resume
python3 scripts/roku_control.py --ip 192.168.1.100 key InstantReplay
sleep 1
python3 scripts/roku_control.py --ip 192.168.1.100 key Play

Movie Night Setup

bash

# Launch streaming app, adjust volume
python3 scripts/roku_control.py --ip 192.168.1.100 launch "Disney+"
sleep 2
python3 scripts/roku_control.py --ip 192.168.1.100 key VolumeDown
python3 scripts/roku_control.py --ip 192.168.1.100 key VolumeDown

Device Mapping

Store your Roku IP in references/roku.json:

json

{
  "living_room": {
    "ip": "192.168.1.100",
    "name": "Living Room TV",
    "model": "Roku Ultra"
  },
  "bedroom": {
    "ip": "192.168.1.101",
    "name": "Bedroom Roku",
    "model": "Roku Streaming Stick+"
  }
}

Then reference by friendly name in conversations.

Troubleshooting

"No Roku devices found"

Ensure Roku is powered on and connected to network
Check that OpenClaw and Roku are on same network/subnet
Some routers block SSDP discovery - try manual IP if known
Verify Roku's network settings in Settings → Network

"Connection timeout"

Verify IP address is correct
Ping the Roku: ping <roku-ip>
Check firewall isn't blocking port 8060
Roku may have changed IP (use DHCP reservation)

"Key not working"

Some keys only work on Roku TVs (volume, power, inputs)
Volume keys require HDMI-CEC or Roku TV
Power commands may not be supported on older devices
Check references/remote-keys.md for compatibility

App won't launch

Verify app is installed: run apps command
Use correct app ID (case-sensitive for name matching)
Some apps require additional authentication in their own UI

Discovery not finding device

Try manual IP if you know it: check router DHCP leases
Roku's IP is shown in Settings → Network → About
Set static IP or DHCP reservation for reliability

Integration with Other Skills

Movie Night Routine

Combine with Govee lights skill:

bash

# Dim lights
for light in "living room" "tv lights"; do
  python3 govee-lights/scripts/govee_control.py brightness "$light" 15
  python3 govee-lights/scripts/govee_control.py temp "$light" 2700
done

# Launch streaming app
python3 roku-control/scripts/roku_control.py --ip 192.168.1.100 launch Netflix

# Set comfortable volume
python3 roku-control/scripts/roku_control.py --ip 192.168.1.100 key VolumeDown

Notes

ECP protocol works entirely over LAN (no internet required)
No authentication or API keys needed
Commands are instant (local network speed)
Multiple Roku devices can be controlled independently
Works with Roku TVs, streaming sticks, and boxes
Power-on commands not supported (ECP limitation - Roku must be awake)
For power-on, use HDMI-CEC or network wake features if available

Limitations

Cannot power on a fully-off Roku (ECP only works when device is on)
Volume/power commands limited to Roku TVs or HDMI-CEC setups
No feedback on success/failure for some commands
Text input is character-by-character (slower for long searches)
Discovery requires SSDP (some networks block multicast)

Score

0–100

50/ 100

Grade

Popularity15/30

748 installs — growing adoption.

Completeness18/30

Documented: description, one-line install, catalog metadata. Missing: SKILL.md body.

Trust6/25

Limited provenance information — review the source before installing.

Freshness11/15

Updated within the last 6 months.

Scored automatically from popularity, completeness, trust, and freshness — computed only from data in our catalog, never fabricated.

Proud of your score? Add this badge to your README.

Paste a snippet into your GitHub README. The badge updates automatically and links back to this page.

Score badge

Markdown

[![Roku Control skill](https://www.remoteopenclaw.com/skills/imaloney/roku-control/badges/score.svg)](https://www.remoteopenclaw.com/skills/imaloney/roku-control)

HTML

<a href="https://www.remoteopenclaw.com/skills/imaloney/roku-control"><img src="https://www.remoteopenclaw.com/skills/imaloney/roku-control/badges/score.svg" alt="Roku Control skill"/></a>