Roku CLI

通过ECP API控制Roku设备的快速TypeScript CLI。

安装

npm install -g roku-ts-cli@latest

快速开始

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

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

命令

交互模式

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

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

桥接服务

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

# 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

通过HTTP发送命令：

# 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"

桥接端点

别名

# 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

遥控器按键

主页，返回，选择，上，下，左，右，播放，暂停，快退，快进，重播，信息，电源，音量加，音量减，静音

备注

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

来源

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