https://github.com/lvcabral/brs-desktop
Roku device simulator as a desktop app (macOS, Windows and Linux)
https://github.com/lvcabral/brs-desktop
desktop electron-app emulator roku roku-development simulator
Last synced: 4 months ago
JSON representation
Roku device simulator as a desktop app (macOS, Windows and Linux)
- Host: GitHub
- URL: https://github.com/lvcabral/brs-desktop
- Owner: lvcabral
- License: mit
- Created: 2019-09-28T01:09:20.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2026-01-22T00:01:16.000Z (5 months ago)
- Last Synced: 2026-01-26T13:32:08.260Z (5 months ago)
- Topics: desktop, electron-app, emulator, roku, roku-development, simulator
- Language: JavaScript
- Homepage:
- Size: 70.8 MB
- Stars: 53
- Watchers: 3
- Forks: 12
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: docs/contributing.md
- License: LICENSE
Awesome Lists containing this project
README
# BrightScript Simulator - Desktop Application
[](./docs/images/brs-desktop.png)
[](https://github.com/lvcabral/brs-desktop/releases/)
[](https://github.com/lvcabral/brs-desktop/blob/master/LICENSE)
[](https://github.com/lvcabral/brs-desktop/actions/workflows/build.yml)
[](https://sonarcloud.io/summary/new_code?id=lvcabral_brs-emu-app)
[](https://sonarcloud.io/summary/new_code?id=lvcabral_brs-emu-app)
[](https://join.slack.com/t/rokudevelopers/shared_invite/zt-4vw7rg6v-NH46oY7hTktpRIBM_zGvwA)
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:
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: port 8085), 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](./docs/vscode-integration.md) to the [VS Code BrightScript Extension](https://marketplace.visualstudio.com/items?itemName=RokuCommunity.brightscript), 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](https://github.com/lvcabral/brs-desktop/releases) page.
> [!IMPORTANT]
>
> Since version 2.x, the simulator can execute code compatible with Roku OS 15 and includes experimental **SceneGraph** support which is currently in **alpha stage**.
>
>**Please be aware of the following:**
>
>- SceneGraph components may not render correctly
>- Some SceneGraph features are not yet implemented
>- Apps may crash or behave unexpectedly
>- Check all [current limitations](https://github.com/lvcabral/brs-engine/blob/scenegraph/docs/limitations.md) for more details
## Documentation
Below you will find the links for the documentation of this project, how to use, build and contribute to the application.
### Application Architecture
- [Overview Diagram](docs/images/brs-desktop-architecture-overview.png)
### How to Use the Application
- [Menu Options](docs/how-to-use.md#menu-options)
- [Settings Screen](docs/how-to-use.md#settings-screen)
- [Command Line Options](docs/how-to-use.md#command-line-options)
- [Keyboard and Game Pad Control](docs/control-reference.md)
- [Remote Access Services](docs/remote-access.md)
- [Integration with VS Code](docs/vscode-integration.md)
### Contributing
- [How to build from source](docs/build-from-source.md)
- [How to contribute](docs/contributing.md)
### Changelog
- Check the [Changelog](CHANGELOG.md) to view the releases notes.
## Developer Links
- My website: [https://lvcabral.com](https://lvcabral.com)
- My threads: [@lvcabral](https://www.threads.net/@lvcabral)
- My Bluesky: [@lvcabral.com](https://bsky.app/profile/lvcabral.com)
- My twitter: [@lvcabral](https://twitter.com/lvcabral)
- My podcast: [PODebug Podcast](http://podebug.com)
- Check my other [GitHub repositories](https://github.com/lvcabral)
## License
Copyright © 2019-2026 Marcelo Lv Cabral. All rights reserved.
Licensed under [MIT](LICENSE) License.