This project was created to develop a multi-platform desktop application for the BrightScript Simulation Engine, please visit the engine library repository and know all about the project history, features and limitations: http://github.com/lvcabral/brs-engine
The objective of this application is to extend the brs-engine, making it a full Roku device simulator, providing features such as:
- Application Installer (Web: default port 80), allowing deploy of side-loaded apps and screenshots.
- ECP Service (default port 8060), that allows automation and data integration with external applications.
- ECP-2 Service (WebSockets), supporting the Roku mobile application to control the simulator.
- Remote Console (Telnet: ports 8085 and 8080), enabling remote Debugging.
- Customization of display, audio, device model and information, controls, captioning and localization.
- Code Editor and Console for BrightScript code development and debugging.
With remote services enabled, the desktop simulator can be detected and integrated to the VS Code BrightScript Extension, and other development tools, as a real Roku device, for deploy, control, deep linking and debugging. You can find the installers for this desktop application (for all platforms) in the Releases page.
On macOS you can also install it with Homebrew, which picks the Apple Silicon (arm64) or Intel (x64) build for your Mac:
brew tap lvcabral/brs-desktop
brew install --cask brs-desktopTo upgrade to a new release:
brew upgrade --cask brs-desktopImportant
The simulator can execute code compatible with Roku OS 16.0 and includes full SceneGraph support which is currently in beta.
Please be aware of the following:
- SceneGraph components may not render correctly
- Apps may crash or behave unexpectedly
- Check all current limitations for more details
- You can report issues related to the simulation engine on brs-engine repository.
Below you will find the links for the documentation of this project, how to use, build and contribute to the application.
- Menu Options
- Settings Screen
- Command Line Options
- Keyboard and Game Pad Control
- Remote Access Services
- Integration with VS Code
- Check the Changelog to view the releases notes.
- My website: https://lvcabral.com
- My threads: @lvcabral
- My Bluesky: @lvcabral.com
- My twitter: @lvcabral
- My podcast: PODebug Podcast
- Check my other GitHub repositories
Copyright © 2019-2026 Marcelo Lv Cabral. All rights reserved.
Licensed under MIT License.