A simple Roku channel used to execute arbitrary BrightScript files.
This repo contains a Roku channel that shouldn't ever be published to the Roku store. That's pretty silly on the surface! In reality, this project exists purely to answer TODOs and other questions from the BRS project, which aims to build a BrightScript interpreter that runs on non-Roku platforms. A small test channel like this one helps to observe behaviors that are described ambiguously in the BrightScript documentation. After all, a BrightScript interpreter is only useful if it behaves the same way as the official interpreter 😄.
The channel builds with GNU Make, but that's just a wrapper around zip
. Build with make
, and remove compiled artifacts with make clean
.
Test files are hosted in ./testfiles/
, and should keep their code in a sub Main
block. That's not strictly required, but it helps to isolate test files from each other.
NOTE: The list of files available to run is not generated automatically, so adding a new test file requires a modification to Main.xml
to point to it. Simply add another <TestFile>
element like the ones that already exist.
- Ensure your Roku has developer mode enabled. If you're not sure, go through Roku's Setup Guide again.
- Find your Roku's IP address from
Settings > Network > About
. - Navigate to
http://roku.ip.addr.ess
in your browser and enter the username/password you set previously. - Click "Upload", then "Install" or "Replace".
- The "BRS Testbed" channel will automatically launch (assuming there were no compile errors).
Use telnet
to connect to your Roku's IP address on port 8085 to see the output of any print
commands in the testfiles
files.