roku-cli

Roku CLI

A cross platform Roku CLI written in Go.

Features

• Manages multiple Roku devices during development
• Debug Roku output from Telnet ports (TODO)
• Builds and installs apps onto Roku hardware
• Builds apps for submission to the Roku Channel Store
• Scans local network to find all available Roku devices

Installing

1. Install Go
2. Use your prefered dependency management tool to install the required modules from the vendor folder Govendor works well for this purpose
3. go install github.com/oddnetworks/roku-cli

Usage

$ roku-cli COMMAND SUBCOMMAND ARGS

Command: devices|d

All of the devices commands work against your $HOME/.rokuclirc file to store IP address, usernames, and passwords to make working with multiple devices easier.

You can set a current devices and switch between them so that commands like install will always work with the currently active device.

Subcommand: find|f

Scans the local subnet for all available Roku devices.

$ roku-cli devices find
192.168.0.12
192.168.0.100

Subcommand: list|l|ls

List all Roku devices set in your $HOME/.rokuclirc file.

$ roku-cli devices list
0) stick 192.168.0.13 (rokudev/testing12345)
1) roku-3 192.168.0.100 (admin/demo) current

Subcommand: switch|s

Switch Roku devices to set a current one for interacting with.

$ roku-cli devices switch -choice=0
0) stick 192.168.0.13 (rokudev/testing12345) current
1) roku-3 192.168.0.100 (admin/demo)

Subcommand: create|c

Create a new Roku device in your $HOME/.rokuclirc file. All flags are required to create a device.

$ roku-cli devices create --name="roku-2" --ip="10.0.0.12" --username=rokudev --password=roku4life --default=true
0) stick 192.168.0.13 (rokudev/testing12345)
1) roku-3 192.168.0.100 (admin/demo)
2) roku-2 10.0.0.12 (rokudev/roku4life) current

Subcommand: update|u

Update a Roku device in your $HOME/.rokuclirc file. Only flag values that are passed in will be updated. Others will be left alone.

$ roku-cli devices update --choice=1 --name="roku-3" --ip="10.0.0.100"
0) stick 192.168.0.13 (rokudev/testing12345)
1) roku-3 10.0.0.100 (admin/demo)
2) roku-2 10.0.0.12 (rokudev/roku4life) current

Subcommand: delete|d|del

Delete a Roku device in your $HOME/.rokuclirc file.

$ roku-cli devices delete --choice=0
0) stick 192.168.0.13 (rokudev/testing12345) current
1) roku-2 10.0.0.12 (rokudev/roku4life)

Note: Flags also have shorthand versions too.

• --choice (-c)
• --name (-n)
• --ip (-i)
• --username (-u)
• --password (-p)
• --default (-d)

Command: build

This will build a ZIP file to be installed or submitted to Roku for distribution.

$ roku-cli build
Building from path: ./src
Build complete: ./build/channel.zip

$ roku-cli build --source=/some/other/path --destination=/var/tmp --zip=package-v1234.zip
Building from path: /some/other/path
Build complete: /var/tmp/package-v1234.zip

Command: install

This will build a ZIP file and install it to the currently active Roku device.

$ roku-cli install
Building from path: ./src
Build complete: ./build/package.zip
Install complete: roku-2 10.0.0.12
Roku response: "Application Received: 131313131 bytes saves"

$ roku-cli install ~/some/other/path /var/tmp
Building from path: ~/some/other/path
Build complete: /var/tmp/package.zip
Install complete: roku-2 10.0.0.12
Roku response: "Application Received: Identical to previous version -- not replacing"

Command: debug (TODO)

This will connect to the available telnet ports for debugging information being provided by the Roku while your app is running.

$ roku-cli debug
Connected to: roku-2 10.0.0.12

License

Apache 2.0 © Odd Networks