Install & Build

Requirements

• Node.js 24.17+
• npm (bundled with Node.js)
• A Roku device on your local network, or a remote server for remote access

Building distributables also needs platform tools: Xcode Command Line Tools (macOS), Windows SDK (Windows, for the NSIS installer), or standard build essentials — gcc, make, etc. (Linux).

Quick Start (Development)

• Install dependencies (from repo root):

  npm install

• Run the app:

  npm start

• Optional — verify TypeScript across every workspace (API, Electron main/preload, renderer, remote server):

  npm run typecheck

Building Distributable Apps

macOS

npm run build:mac

Creates, under apps/roku-dev-studio/dist/:

• mac/arm64/Roku Dev Studio-{version}-arm64.dmg — Apple Silicon installer
• mac/arm64/Roku Dev Studio-{version}-arm64-mac.zip — portable Apple Silicon app

Intel Mac builds are no longer produced by default; build locally (deprecated) with npm run build:mac:intel.

Windows

npm run build:win

Creates a Windows installer (Roku Dev Studio Setup {version}.exe) and a portable executable, both x64.

Linux

npm run build:linux

Creates a Debian package (.deb, x64 & arm64) and an AppImage (x64 & arm64).

All platforms

npm run build:all

Per-platform notes

macOS — code signing & notarization

By default, electron-builder produces a signed-but-not-notarized build if a Developer ID Application certificate is present in your login keychain, and an ad-hoc-signed build otherwise. Without a Developer ID, end users need to clear quarantine before launching:

xattr -cr "/Applications/Roku Dev Studio.app"

Full one-time signing/notarization setup is in the repo's code-signing notes.

Windows

No code signing is configured by default — Windows shows a SmartScreen warning until you add an Authenticode certificate. Cross-building from macOS/Linux requires Wine; the reliable option is building on Windows (or in a Windows VM / GitHub Actions runner).

Linux

The .deb target lists its runtime dependencies in package.json → build.deb.depends:

libgtk-3-0  libnotify4  libnss3  libxss1  libxtst6  xdg-utils  libatspi2.0-0  libuuid1

Debian/Ubuntu users install with sudo apt install ./Roku Dev Studio-*.deb (apt resolves the depends automatically). The AppImage is self-contained — chmod +x and run.

Troubleshooting

Connection issues

• Ensure the Roku and your computer are on the same network
• Control by Mobile Apps (ECP): Settings → System → Advanced system settings → Control by mobile apps → Network access. Roku's Disabled mode blocks remote/keypress entirely; Limited allows text input / app launch / query but not full remote keypress; Permissive needs this computer on the same subnet; Enabled gives full control on private network addresses
• Allow connections on port 8060 in your firewall

Building issues

• macOS code signing: distribution needs an Apple Developer certificate
• Windows builds on macOS: use a Windows VM or GitHub Actions
• Linux builds: ensure the dependencies above are installed on the build host