name: roku
description: 通过命令行控制 Roku 设备。支持设备发现、遥控、应用启动、搜索，并提供 HTTP 桥接模式以实现实时控制。
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":"roku-ts-cli","bins":["roku"],"label":"通过 npm 安装 Roku CLI"}]}}

Roku CLI

一个基于 TypeScript 的快速命令行工具，通过 ECP API 控制 Roku 设备。

安装

npm install -g roku-ts-cli@latest

快速开始

# 发现设备并保存别名
roku discover --save livingroom --index 1

# 使用别名
roku --host livingroom device-info
roku --host livingroom apps

命令列表

交互式模式

roku livingroom                    # 交互式控制
roku --host livingroom interactive # 同上

使用方向键、回车键、ESC 键进行类似遥控器的控制。

桥接服务

以原生操作系统服务的形式运行一个持久的 HTTP 桥接服务：

# 安装并启动服务
roku bridge install-service --port 19839 --token secret --host livingroom --user
roku bridge start --user

# 服务管理
roku bridge status --user
roku bridge stop --user
roku bridge uninstall --user

通过 HTTP 发送命令：

# 发送按键指令
curl -X POST http://127.0.0.1:19839/key \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer secret" \
  -d '{"key":"home"}'

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

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

# 健康检查
curl http://127.0.0.1:19839/health -H "Authorization: Bearer secret"

桥接服务端点

别名管理

# 保存设备别名
roku discover --save livingroom --index 1
roku alias set office 192.168.1.20

# 保存应用别名
roku alias set plex 13535

# 列出所有别名
roku alias list

# 使用别名
roku --host livingroom launch plex

遥控按键

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

注意事项

• Roku 设备必须与 CLI 在同一网络中
• 桥接服务以原生 launchd（macOS）或 systemd（Linux）服务形式运行
• 使用 --user 标志以用户空间服务运行（无需 sudo）
• 在桥接模式下使用 --token 进行身份验证

源码

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