RoonPilot primary firmware

Firmware Installer

The primary ESP32-S3 firmware is installed only through this authorized browser installer. Factory and OTA images are not offered as standalone downloads.

▶ Watch the step-by-step installation video
Two independent processors. Check the name before the parentheses in the device chooser and select USB JTAG/serial debug unit for this installer. A Factory installation erases the complete ESP32-S3 and all of its settings. An original-firmware backup is optional and useful only if you may want to restore the exact manufacturer-delivered state later.
ESP32-S3 only · USB Web Serial

Install in the browser

Use a current desktop Chromium browser such as Chrome or Edge. Close every serial monitor before continuing. Firefox and Safari do not support this Web Serial workflow.

Choose the firmware

Selected: RoonPilot 2.0.2 · clean USB installation with erase

Entry in the device chooser

Use these names in the Web Installer device chooser. The name before the parentheses is what matters:

Target deviceWindowsmacOS
RoonPilot main ESP32-S3USB JTAG/serial debug unit (COM…)USB JTAG/serial debug unit (cu.usbmodem…)
RoonPilot companion, classic ESP32USB serial (COM…)USB serial (cu.usbserial… or cu.wchusbserial…)
Separate IR Bridge, ESP32-S3USB JTAG/serial debug unit (COM…)USB JTAG/serial debug unit (cu.usbmodem…)

Select the first row here. No preliminary operating-system or esptool check is required. If the open chooser shows USB serial, unplug USB, turn the USB-C plug at the round RoonPilot device by 180° and reconnect it. The Web Installer immediately detects the device again. The Bridge row applies only to the separate Bridge Web Installer.

Erase during a Factory installation

Erase is mandatory and performed automatically before flashing. There is no optional erase checkbox to leave unchecked. Save any configuration backup you need before continuing. This clean installation erases all settings and profiles on RoonPilot, including Wi-Fi and Bridge pairings. Set up Wi-Fi and Roon again afterward and pair your Bridges again. It does not flash the companion ESP32 or any separate Bridge.

Use a current desktop Chromium browser with Web Serial, for example Chrome or Edge. Open this HTTPS page before connecting the USB device.
Continue after flashing

New installation? Start here.

The First Setup Guide walks through the temporary Wi-Fi network, Roon approval and the zone picker in the correct order.

Open the First Setup Guide
Factory installation

Available only through the Web Installer above. It erases the ESP32-S3 before installing RoonPilot.

Online updates

RoonPilot's internal online updater is temporarily suspended. Use the USB Web Installer above.

Separate classic ESP32 · optional

Companion Sleep firmware

It releases shared signals, mutes the unused DAC path and puts the board's second ESP32 into deep sleep. RoonPilot also works fully without it.

The normal installation also needs no Python or command line and uses its own Web Installer. Select USB serial in the browser chooser, not USB JTAG/serial debug unit.

Open the Companion Web Installer

Purpose and separate Windows/macOS instructions

Proprietary RoonPilot portions

License and third-party notices

Official, unmodified RoonPilot firmware may be installed and used privately on supported hardware. RoonPilot-authored code, assets and integration may not be redistributed, modified, reverse engineered or used in another product. Independently licensed third-party components retain their own rights and licenses.