{"skill":{"slug":"roku-control","displayName":"Roku Control","summary":"Control Roku devices via local network (ECP protocol). Use when the user wants to control their Roku TV or streaming device, change channels, launch apps (Netflix, YouTube, Hulu, etc.), navigate menus, adjust volume, play/pause content, search for shows, or power off. Works over LAN with no authentication required.","description":"---\nname: roku-control\ndescription: \"Control Roku devices via local network (ECP protocol). Use when the user wants to control their Roku TV or streaming device, change channels, launch apps (Netflix, YouTube, Hulu, etc.), navigate menus, adjust volume, play/pause content, search for shows, or power off. Works over LAN with no authentication required.\"\n---\n\n# Roku Control\n\nControl Roku devices over your local network using the External Control Protocol (ECP). No authentication, cloud services, or complex setup required - just local HTTP commands.\n\n## Prerequisites\n\n- Roku device on the same network as OpenClaw\n- Roku's IP address (can be discovered automatically)\n\n## Setup (First Time)\n\n**1. Discover your Roku:**\n\n```bash\npython3 scripts/roku_control.py discover\n```\n\nThis will show all Roku devices on your network with their IP addresses.\n\n**2. Save the IP address:**\n\nNote your Roku's IP (e.g., `192.168.1.100`) for use in commands.\n\n**3. Test connectivity:**\n\n```bash\npython3 scripts/roku_control.py --ip 192.168.1.100 info\n```\n\n## Common Operations\n\n### Device Information\n\n```bash\n# Get device details\npython3 scripts/roku_control.py --ip 192.168.1.100 info\n\n# List all installed apps\npython3 scripts/roku_control.py --ip 192.168.1.100 apps\n\n# See what's currently playing\npython3 scripts/roku_control.py --ip 192.168.1.100 active\n```\n\n### Navigation & Control\n\n```bash\n# Navigate menus\npython3 scripts/roku_control.py --ip 192.168.1.100 key Up\npython3 scripts/roku_control.py --ip 192.168.1.100 key Down\npython3 scripts/roku_control.py --ip 192.168.1.100 key Left\npython3 scripts/roku_control.py --ip 192.168.1.100 key Right\npython3 scripts/roku_control.py --ip 192.168.1.100 key Select\n\n# Go home\npython3 scripts/roku_control.py --ip 192.168.1.100 key Home\n\n# Go back\npython3 scripts/roku_control.py --ip 192.168.1.100 key Back\n```\n\n### Playback\n\n```bash\n# Play/pause\npython3 scripts/roku_control.py --ip 192.168.1.100 key Play\npython3 scripts/roku_control.py --ip 192.168.1.100 key Pause\n\n# Rewind/fast forward\npython3 scripts/roku_control.py --ip 192.168.1.100 key Rev\npython3 scripts/roku_control.py --ip 192.168.1.100 key Fwd\n\n# Instant replay (back 10 seconds)\npython3 scripts/roku_control.py --ip 192.168.1.100 key InstantReplay\n```\n\n### Volume & Power\n\n```bash\n# Volume control (Roku TV or HDMI-CEC enabled)\npython3 scripts/roku_control.py --ip 192.168.1.100 key VolumeUp\npython3 scripts/roku_control.py --ip 192.168.1.100 key VolumeDown\npython3 scripts/roku_control.py --ip 192.168.1.100 key VolumeMute\n\n# Power off\npython3 scripts/roku_control.py --ip 192.168.1.100 key PowerOff\n```\n\n### Launch Apps\n\n```bash\n# Launch by app ID (faster)\npython3 scripts/roku_control.py --ip 192.168.1.100 launch 12  # Netflix\n\n# Launch by app name (case-insensitive)\npython3 scripts/roku_control.py --ip 192.168.1.100 launch Netflix\npython3 scripts/roku_control.py --ip 192.168.1.100 launch YouTube\npython3 scripts/roku_control.py --ip 192.168.1.100 launch \"Disney+\"\n```\n\n### Search & Text Input\n\n```bash\n# Send search text\npython3 scripts/roku_control.py --ip 192.168.1.100 text \"Breaking Bad\"\n\n# This is much faster than individual key presses for searches\n```\n\n## Natural Language Translation\n\nMap user requests to commands:\n\n**Navigation:**\n- \"Go to home screen\" → `key Home`\n- \"Go back\" → `key Back`\n- \"Scroll down\" / \"Move down\" → `key Down`\n- \"Select this\" / \"Click\" → `key Select`\n\n**Playback:**\n- \"Play\" / \"Resume\" → `key Play`\n- \"Pause\" → `key Pause`\n- \"Rewind\" → `key Rev`\n- \"Fast forward\" → `key Fwd`\n- \"Go back 10 seconds\" / \"Replay that\" → `key InstantReplay`\n\n**Volume:**\n- \"Turn up the volume\" → `key VolumeUp`\n- \"Turn down the volume\" → `key VolumeDown`\n- \"Mute\" / \"Unmute\" → `key VolumeMute`\n\n**Apps:**\n- \"Open Netflix\" → `launch Netflix`\n- \"Launch YouTube\" → `launch YouTube`\n- \"Start Hulu\" → `launch Hulu`\n\n**Search:**\n- \"Search for Breaking Bad\" → `text \"Breaking Bad\"`\n- \"Find Stranger Things\" → Open search + send text\n\n**Power:**\n- \"Turn off the TV\" → `key PowerOff`\n\n## Common App IDs\n\nSee [references/common-apps.md](references/common-apps.md) for a comprehensive list.\n\nQuick reference:\n- Netflix: 12\n- YouTube: 837\n- Hulu: 2285\n- Disney+: 291097\n- Amazon Prime Video: 13\n- HBO Max: 61322\n- The Roku Channel: 151908\n\nTo get app IDs for your specific Roku:\n```bash\npython3 scripts/roku_control.py --ip <ip> apps\n```\n\n## Complete Key Reference\n\nSee [references/remote-keys.md](references/remote-keys.md) for all supported remote keys.\n\nCommon keys: `Home`, `Back`, `Up`, `Down`, `Left`, `Right`, `Select`, `Play`, `Pause`, `Rev`, `Fwd`, `VolumeUp`, `VolumeDown`, `VolumeMute`, `PowerOff`, `Search`, `Info`\n\n## Advanced Workflows\n\n### Watch Netflix\n\n```bash\n# Go home, launch Netflix\npython3 scripts/roku_control.py --ip 192.168.1.100 key Home\nsleep 1\npython3 scripts/roku_control.py --ip 192.168.1.100 launch 12\n```\n\n### Search and Play\n\n```bash\n# Open search, send text, select first result\npython3 scripts/roku_control.py --ip 192.168.1.100 key Search\nsleep 1\npython3 scripts/roku_control.py --ip 192.168.1.100 text \"The Office\"\nsleep 1\npython3 scripts/roku_control.py --ip 192.168.1.100 key Select\n```\n\n### Quick Replay\n\n```bash\n# Go back 10 seconds and resume\npython3 scripts/roku_control.py --ip 192.168.1.100 key InstantReplay\nsleep 1\npython3 scripts/roku_control.py --ip 192.168.1.100 key Play\n```\n\n### Movie Night Setup\n\n```bash\n# Launch streaming app, adjust volume\npython3 scripts/roku_control.py --ip 192.168.1.100 launch \"Disney+\"\nsleep 2\npython3 scripts/roku_control.py --ip 192.168.1.100 key VolumeDown\npython3 scripts/roku_control.py --ip 192.168.1.100 key VolumeDown\n```\n\n## Device Mapping\n\nStore your Roku IP in `references/roku.json`:\n\n```json\n{\n  \"living_room\": {\n    \"ip\": \"192.168.1.100\",\n    \"name\": \"Living Room TV\",\n    \"model\": \"Roku Ultra\"\n  },\n  \"bedroom\": {\n    \"ip\": \"192.168.1.101\",\n    \"name\": \"Bedroom Roku\",\n    \"model\": \"Roku Streaming Stick+\"\n  }\n}\n```\n\nThen reference by friendly name in conversations.\n\n## Troubleshooting\n\n**\"No Roku devices found\"**\n- Ensure Roku is powered on and connected to network\n- Check that OpenClaw and Roku are on same network/subnet\n- Some routers block SSDP discovery - try manual IP if known\n- Verify Roku's network settings in Settings → Network\n\n**\"Connection timeout\"**\n- Verify IP address is correct\n- Ping the Roku: `ping <roku-ip>`\n- Check firewall isn't blocking port 8060\n- Roku may have changed IP (use DHCP reservation)\n\n**\"Key not working\"**\n- Some keys only work on Roku TVs (volume, power, inputs)\n- Volume keys require HDMI-CEC or Roku TV\n- Power commands may not be supported on older devices\n- Check [references/remote-keys.md](references/remote-keys.md) for compatibility\n\n**App won't launch**\n- Verify app is installed: run `apps` command\n- Use correct app ID (case-sensitive for name matching)\n- Some apps require additional authentication in their own UI\n\n**Discovery not finding device**\n- Try manual IP if you know it: check router DHCP leases\n- Roku's IP is shown in Settings → Network → About\n- Set static IP or DHCP reservation for reliability\n\n## Integration with Other Skills\n\n### Movie Night Routine\n\nCombine with Govee lights skill:\n\n```bash\n# Dim lights\nfor light in \"living room\" \"tv lights\"; do\n  python3 govee-lights/scripts/govee_control.py brightness \"$light\" 15\n  python3 govee-lights/scripts/govee_control.py temp \"$light\" 2700\ndone\n\n# Launch streaming app\npython3 roku-control/scripts/roku_control.py --ip 192.168.1.100 launch Netflix\n\n# Set comfortable volume\npython3 roku-control/scripts/roku_control.py --ip 192.168.1.100 key VolumeDown\n```\n\n## Notes\n\n- ECP protocol works entirely over LAN (no internet required)\n- No authentication or API keys needed\n- Commands are instant (local network speed)\n- Multiple Roku devices can be controlled independently\n- Works with Roku TVs, streaming sticks, and boxes\n- Power-on commands not supported (ECP limitation - Roku must be awake)\n- For power-on, use HDMI-CEC or network wake features if available\n\n## Limitations\n\n- Cannot power on a fully-off Roku (ECP only works when device is on)\n- Volume/power commands limited to Roku TVs or HDMI-CEC setups\n- No feedback on success/failure for some commands\n- Text input is character-by-character (slower for long searches)\n- Discovery requires SSDP (some networks block multicast)\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":1366,"installsAllTime":51,"installsCurrent":1,"stars":0,"versions":1},"createdAt":1770609726959,"updatedAt":1778486092879},"latestVersion":{"version":"1.0.0","createdAt":1770609726959,"changelog":"Initial release: Local network control for Roku devices via ECP protocol. Features include device discovery, remote control, app launching, power control, and text input. No authentication or cloud services required.","license":null},"metadata":null,"owner":{"handle":"imaloney","userId":"s1757q0cfqqw6rj3cas03vynf984e3tz","displayName":"IMaloney","image":"https://avatars.githubusercontent.com/u/21049395?v=4"},"moderation":null}