roku

# Roku CLI

Fast TypeScript CLI for controlling Roku devices via the ECP API.

## Installation

```bash
npm install -g roku-ts-cli@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 |
|----------|----...

# roku-cli

A pure Bash CLI to control your Roku from the terminal. Built on [python-roku](https://github.com/jcarbaugh/python-roku).

## Features

- 🔍 **Discover** Roku devices on your network
- 🎮 **Control** playback and navigation
- ⌨️ **Text entry** for search fields
- 📱 **Launch** apps by name or ID
- 📊 **Status** monitoring (active app, device info)

## Requirements

- Python 3.7+
- `pip3 install roku`
- Bash 4+

## Installation

```bash
# Install the python-roku library
pip3 install roku

# Download and link the CLI
git clone https://github.com/gumadeiras/roku-cli.git
cd roku-cli
chmod +x roku-cli
ln -sf $(pwd)/roku-cli ~/.local/bin/roku
```

Or install via [ClawdHub](https://clawdhub.com):

```bash
clawdhub install roku
```

## Quick Start

Find your Roku:
```bash
roku discover
```

Control it:
```bash
roku press home        # Go to home screen
roku press select      # OK button
roku press right
roku press play
roku press back
```

Enter text (e.g., in search):
```bash
roku text "netflix"
```

Launch apps:
```bash
roku apps              # List all apps
roku launch Netflix    # By name
roku launch 12         # By app ID
```

Check status:
```bash
roku active            # Current app
roku info              # Device info
```

## Usage

```
Usage: roku [OPTIONS] COMMAND [ARGS]

Options:
  --ip IP       Roku IP address (or set ROKU_IP env var)
  --help        Show this help

Commands:
  discover      Find Roku devices on network
  press BUTTON  Send button press
  text STRING   Enter text
  apps          List installed apps
  launch APP    Launch app (name or ID)
  active        Show active app
  info          Show device info
```

## Buttons

`home`, `back`, `left`, `right`, `up`, `down`, `select`, `enter`, `info`, `play`, `forward`, `reverse`, `replay`, `search`, `backspace`, `channel_up`, `channel_down`

## Environment

Set `ROKU_IP` to avoid specifying `--ip` each time:

```bash
export ROKU_IP="192.168.1.100"
```

## Roku Settings

For external control to...