Gustavo Madeira Santana

roku

Developmentv2.0.1
By Gustavo Madeira SantanaUpdated 2026-05-155 versions · latest released 2026-05-15@clawhub_gumadeiras/roku
Scripting

According to AlphaMoat, as of 2026-09, roku has 3,189 downloads and 0 stars — ranked #3,575 of 5,078 AI skills overall, and #456 of 577 in Development.

Installs
102
Downloads
3.2K
Stars
-
Overall Rank
#3,575
Top 71% overall · Top 80% in Development
PlatformInstallsDownloadsStarsComments
ClawHub ↗1023.1K--
SkillHub ↗1023.2K-—

Platforms count differently and update at different times.

What this skill does

It can inspect device information and installed apps, send remote keys, enter text, search for content, or launch an app. An optional persistent HTTP bridge is also available. Commands control real devices, and an exposed bridge may be abused. Confirm the target and restrict the service bind address, token, and access scope before use.

Profile published 2026-10-29

What you can do with it

  • Discover Roku devices on the local network and inspect device information.
  • Send remote-control keys, text input, content searches, or app-launch commands.
  • Inspect the HTTP bridge status and plan its secure configuration.

When to use it

  • When inspecting or controlling Roku devices from a CLI.
  • When sending remote-control commands through a script or controlled service.
  • Before state-changing commands or enabling the HTTP bridge, when target, authorization, authentication, and network exposure need confirmation.

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Discover local Roku devices and inspect their information without sending remote-control commands.
Check the bridge bind address and authentication method; do not start the service or send device-control requests.

Monthly Trend

Downloads3.2K
2.0K2.6K3.3K2026-03 · Downloads 2.1K2026-05 · Downloads 2.6K2026-06 · Downloads 2.7K2026-07 · Downloads 2.9K2026-08 · Downloads 3.0K2026-09 · Downloads 3.2K26-0326-09
Stars-
0112026-03 · Stars -2026-05 · Stars -2026-06 · Stars -2026-07 · Stars -2026-08 · Stars -2026-09 · Stars -26-0326-09

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

MonthDownloadsMoMStars
2026-093.2K—-
2026-083.0K+2.4%-
2026-072.9K+7.5%-
2026-062.7K+5.2%-
2026-052.6K—-
2026-032.1K—-

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

3.3 KB · ClawHub v2.0.1
---
name: roku
description: Control Roku devices via CLI. Discovery, remote control, app launching, search, and HTTP bridge mode for real-time control.
homepage: https://github.com/gumadeiras/roku-cli
repository: https://github.com/gumadeiras/roku-cli
metadata: {"clawdbot":{"emoji":"📺","requires":{"bins":["roku"]},"install":[{"id":"node","kind":"node","package":"@gumadeiras/roku","bins":["roku"],"label":"Install Roku (npm)"}]}}
---

# Roku CLI
Show all (134 lines)
Fast TypeScript CLI for controlling Roku devices via the ECP API.

## Installation

```bash
npm install -g @gumadeiras/roku@latest
```

## Quick Start

```bash
# Discover devices and save an alias
roku discover --save livingroom --index 1

# Use the alias
roku --host livingroom device-info
roku --host livingroom apps
```

## Commands

| Command | Description |
|---------|-------------|
| `roku discover` | Find Roku devices on network |
| `roku --host <ip> device-info` | Get device info |
| `roku --host <ip> apps` | List installed apps |
| `roku --host <ip> command <key>` | Send remote key |
| `roku --host <ip> literal <text>` | Type text |
| `roku --host <ip> search --title <query>` | Search content |
| `roku --host <ip> launch <app>` | Launch app |
| `roku --host <ip> interactive` | Interactive remote mode |

## Interactive Mode

```bash
roku livingroom                    # interactive control
roku --host livingroom interactive # same thing
```

Use arrow keys, enter, escape for remote-like control.

## Bridge Service

Run a persistent HTTP bridge as a native OS service:

```bash
# Install and start the service
roku bridge install-service --port 19839 --token secret --host livingroom --user
roku bridge start --user

# Service management
roku bridge status --user
roku bridge stop --user
roku bridge uninstall --user
```

Send commands via HTTP:

```bash
# Send key
curl -X POST http://127.0.0.1:19839/key \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer secret" \
  -d '{"key":"home"}'

# Type text
curl -X POST http://127.0.0.1:19839/text \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer secret" \
  -d '{"text":"hello"}'

# Launch app
curl -X POST http://127.0.0.1:19839/launch \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer secret" \
  -d '{"app":"plex"}'

# Health check
curl http://127.0.0.1:19839/health -H "Authorization: Bearer secret"
```

### Bridge Endpoints

| Endpoint | Body |
|----------|------|
| `POST /key` | `{"key": "home"}` |
| `POST /text` | `{"text": "hello"}` |
| `POST /search` | `{"title": "Stargate"}` |
| `POST /launch` | `{"app": "plex"}` |
| `GET /health` | — |
| `GET /health?deep=1` | Deep health check (probes Roku) |

## Aliases

```bash
# Save device alias
roku discover --save livingroom --index 1
roku alias set office 192.168.1.20

# Save app alias  
roku alias set plex 13535

# List aliases
roku alias list

# Use aliases
roku --host livingroom launch plex
```

## Remote Keys

home, back, select, up, down, left, right, play, pause, rev, fwd, replay, info, power, volume_up, volume_down, mute

## Notes

- Roku must be on the same network as the CLI
- Bridge service runs as a native launchd (macOS) or systemd (Linux) service
- Use `--user` flag for user-space service (no sudo required)
- Use `--token` for authentication in bridge mode

## Source

https://github.com/gumadeiras/roku-cli

Popular in Development

More from Gustavo Madeira Santana

Data month: 2026-09 · Downloads, stars and installs are aggregated monthly from public skill registries (ClawHub, SkillHub). See methodology.