Roon control,
right where the music is.

A fast, tactile Roon remote for the Waveshare ESP32-S3 Knob Touch LCD 1.8. No server bridge, companion app or additional service is required; optional IR hardware control can be enabled when a zone needs it.

RoonPilot online updates are temporarily suspended. Do not use the internal updater. Use the USB Web Installer for a clean 2.0.2 installation; it erases settings and pairings. IR Bridge online updates remain available.

Current USB firmware: 2.0.2. RoonPilot online updates are paused. Both USB Web Installers and optional IR Bridge 1.0.0 updates remain available. Read the 2.0.2 Release Notes and installation guidance.

  • Direct local Roon connection
  • Touch and rotary control
  • Optional per-zone IR Bridge
  • Signed A/B updates
Original blue Waveshare ESP32-S3 Knob Touch LCD 1.8 running RoonPilot

Step-by-step video guides

Choose the installation you want to see.

Each guide shows the browser screens, device selection and the steps that follow. Pause the video and continue at your own pace.

Main device

RoonPilot

Install the firmware on the round display and complete the first Wi-Fi setup.

Watch RoonPilot video

Optional second processor

Companion firmware

See what the low-power firmware does and how to select the correct USB processor.

Watch Companion video

Optional external hardware

IR Bridge

Connect the components, flash the separate board, pair it and learn the remote.

Watch IR Bridge video

Personal hobby project · no business model

Made for the joy of music and technology

RoonPilot was created for the enjoyment of music, technology and building something useful—not as a commercial venture. There are no advertisements, subscriptions or hidden costs. RoonPilot does not transmit personal, usage or telemetry data to the developer or any third party.

Support and discussion: use the Roon Community Forum thread or GitHub Issues.

Anyone who would voluntarily like to say thank you for the time and effort invested:

The browser shows the connected processor.

In the Web Installer's device chooser, simply read the name before the parentheses. The additional COM… or cu.usbmodem… value may differ.

Select for RoonPilot

USB JTAG/serial debug unit

This is the ESP32-S3 for the display, touch, rotary ring, Wi-Fi and RoonPilot firmware.

Unplug firstTurn the USB-C plug by 180°
Other plug position

USB serial

This is the separate classic companion processor, not the target of the main RoonPilot installer.

No preliminary check needed. If the open chooser shows USB serial, unplug USB, turn the USB-C plug by 180 degrees and reconnect it. The browser detects the device again immediately. Device Manager and System Information remain optional additional checks.
Optional technical background: the two processors

01

Start directly in the Web Installer

The browser handles device selection; no operating-system tool is needed beforehand.

  1. 1

    Use a USB data cable

    A charge-only cable can power the display but cannot transfer firmware.

  2. 2

    Open the Web Installer

    Use Chrome or Edge, enable the confirmations and start installation. The device chooser then opens.

  3. 3

    Read the name before parentheses

    Select USB JTAG/serial debug unit for RoonPilot. COM… or cu.usbmodem… appears only as additional information in parentheses.

  4. 4

    Turn the plug if the entry is wrong

    For USB serial, leave the chooser open, unplug USB, turn the USB-C plug by 180 degrees and reconnect it. The browser refreshes the choice immediately.

An original-firmware backup is optional and not a prerequisite for RoonPilot.

02

Install RoonPilot in the browser

The Web Installer shows the correct USB entry directly in its chooser.

Installation checklist
ESP32-S3
USB cable
Data capable
Browser entry
USB JTAG/serial debug unit
Browser
Chrome or Edge

When asked, confirm Erase device. No separate erase is needed beforehand.

Keep USB connected until erase, write and verification are complete.

Later updates run directly from RoonPilot under System → Firmware update and normally preserve settings.

Browser: current desktop Chromium with Web Serial only. Device choice: the name before the parentheses is what matters. The chooser can stay open while USB is disconnected, turned and reconnected.

03

After the first installation

Normal updates no longer require a USB cable.

TaskWhereWhat happensNeeded?
First installationWeb Installer with USBInstalls RoonPilot on the ESP32-S3Once
Later updatesRoonPilot → SystemDownloads and installs the approved updateAs offered
Companion firmwareSeparate Web Installer with USBPuts the unused second processor into deep sleepOptional

See the optional Companion installation before selecting its USB processor.

Watch Companion video

The Companion firmware is optional.

RoonPilot works fully without it. The separate Companion guide for Windows or macOS also leads directly to its own Web Installer restricted to the classic companion ESP32.

04

From first boot to Roon control

A clean factory image contains no private Wi-Fi or Roon data.

  1. 1

    Join the setup Wi-Fi

    On your phone or computer, choose RoonPilot-Setup-XXXXXX in Wi-Fi settings. Password: roonpilot-setup. Stay connected even if it says “No Internet”. Then, on that same phone or computer, enter http://192.168.4.1 in the browser address bar.

  2. 2

    Connect Wi-Fi

    Select or enter your 2.4 GHz network and save the password locally on the device.

  3. 3

    Open the local UI

    Use the address shown by your router or the device. No Internet account is required.

  4. 4

    Approve RoonPilot

    In Roon, open Settings → Extensions and enable RoonPilot by Senior Coder.

  5. 5

    Select the server

    If several Roon Servers are found, choose the intended one. A fixed local IP can be entered when discovery is blocked.

  6. 6

    Choose your zones

    Select the primary zone and hide rooms that should not appear on the device.

Wrong Wi-Fi password? After about 45 seconds RoonPilot returns to its setup AP, so the credentials can be corrected without erasing or reflashing.

05

Built for the way you listen

Fast physical control, a considered round interface and complete local configuration.

Current RoonPilot Classic player with cover artwork, progress and controls

Tactile control. Beautifully simple.

Turn the full outer ring for volume. RoonPilot automatically follows dimensionless, dB and relative outputs without inventing a unit. Tap, swipe or hold the capacitive display for playback and device controls.

  • Play/pause, previous and next on the display
  • Horizontal swipe for track changes
  • Four selectable player layouts, including artwork-free Aura
  • Zone picker, native unitless/dB volume and Roon-pairing screens
  • Station and digital clocks with day/night brightness
  • Quick settings, optional control lock and centre double-tap display-off
  • Optional artwork-sized centre Play/Pause touch area
  • Optional Roon playlists, Live Radio, Power and Mute shortcuts
  • Adjustable touch vibration without vibration while turning
  • UTF-8 metadata with broad European, Greek, Cyrillic and selected emoji glyph coverage

Turn · tap · double-tap · swipe · hold

Every gesture at a glance.

Volume, transport, zone selection, Quick Settings, control lock, immediate display-off and wake-up are available directly on the device.

Read the complete device controls
Authoritative current RoonPilot Classic player

Open the current Classic reference at full size

ActionStarting pointResult
Turn the outer ringSingle zoneChanges volume through the native Roon or IR route saved for that zone.
Turn the first detentRoon groupOpens the group mixer without changing a level. Keep turning to control the whole group, or tap a large member row and then turn to control only that output.
Tap a visible buttonPlayerOperates Previous, Play/Pause, Next or an enabled side shortcut for Playlist, Live Radio, Power or Mute.
Tap the zone namePlayerOpens the zone picker.
Swipe left/rightPlayerMoves to the next/previous track.
Swipe upPlayerOpens Quick Settings.
Hold the centre for about 1.2 sPlayerLocks or unlocks all controls.
Double-tap the centreLarge Play/Pause area offSwitches the display completely off immediately.
Short-tap the large centreOptional Play/Pause area onToggles playback in all four player layouts. Visible buttons retain priority; the area remains invisible and is off by default.
First touch or ring detentBlack displayWakes only the display. Music and volume are left unchanged.
Diagram of the optional large centre Play/Pause touch area
Optional easier target: Display & Controls can enable an invisible, roughly artwork-sized Play/Pause area. One short tap anywhere inside the marked region is enough; open the diagram directly for its full-size view.

Web interface. Total local control.

The responsive local interface manages RoonPilot directly from the same network and switches together with the device display between English and German.

  • Roon Server and zone management
  • Display, rotary, touch, CPU, sleep and USB-power settings
  • Per-zone ring steps, Power/Mute and up to three named HTTP on/off action pairs
  • On-demand Roon playlists and saved Live Radio stations with one order shared by web page and device
  • Configuration export/import without secrets
  • Signed online A/B firmware updates
  • Visible update status with separate web/device notification controls
  • Battery-hardware selector, conditional runtime calibration, persistent event log and diagnostics
  • One English/German setting for the display, Quick Settings and every local page
  • Guarded deep sleep with touch and rotary wake
Current RoonPilot local web interface overview with fictional data

06

One Roon group. Every physical output under control.

RoonPilot preserves the volume route of every group member instead of treating unlike devices as one anonymous endpoint.

No extra on-screen button

The first detent opens the mixer. The next movement controls the music.

A Roon group may combine a native numeric endpoint, a real dB endpoint, relative Roon volume and several IR-controlled devices. RoonPilot sends the correct command to each physical output and displays every result in its honest unit—such as 48, −35.0 dB and IR +2 side by side.

Tap a generously sized member row to adjust only that output. Tap the group heading to return to the complete group. The mixer closes automatically after eight seconds of inactivity.

Read the complete group guide
Group volume overlay showing numeric, dB and infrared routes
Whole group. The group name and every visible output keep their own feedback type.
Group mixer with one physical output selected for individual control
One member. A tap selects the physical output; the ring then changes only that row.
Roon group routed to numeric Roon volume, dB volume and an infrared Bridge
Grouping never overwrites routing. Native Roon and External IR paths can operate together; an unavailable Bridge marks only its own member offline. Open full-size diagram.
First detent is safe

It opens the mixer without changing volume—even when it also wakes a black display.

Up to three touch rows

The round display shows three selectable members; whole-group control still processes every eligible output.

Several Bridges at once

One BLE path and several authenticated Wi-Fi paths can serve the same active Roon group.

Failures stay local

One offline route does not silently move to another Bridge or stop healthy group members.

07

Optional IR control, assigned zone by zone.

RoonPilot remains the only user interface while a small ESP32-S3 Bridge reproduces the original infrared commands beside the audio hardware.

One firmware, optional hardware

Control the DAC itself when Roon cannot.

Each physical Roon output independently selects native Roon volume, an external IR Bridge/profile or deliberately disabled volume. Up to four Bridge pairings can be saved. Automatic zone control follows the selected zone and, for a Roon group, monitors and operates every Bridge required by its members.

Pairing and all sensitive provisioning start over encrypted Bluetooth LE. Authenticated local Wi-Fi is optional for another room and is preferred for a confirmed firmware transfer. Pairing, profiles, learning, routing, diagnostics, backup and signed A/B updates are all managed by RoonPilot—there is no separate Bridge app, cloud account or everyday web page.

Example: WiiM Ultra and RME ADI-2 DAC. Playback continues through Roon and WiiM, while the ring sends learned RME volume commands. The DAC performs its own hardware level change and retains Auto Ref Level instead of substituting Roon digital attenuation.

Watch IR Bridge video

Explore the complete IR Bridge project
RoonPilot IR Bridge connection page showing multiple saved Bridges and automatic zone control with fictional data
Saved does not mean found in the latest BLE scan. The selected zone—or all required members of a Roon group—determines which Bridges RoonPilot monitors and controls.
01

Learn the real remote

Record Volume up/down, Mute and separate Power on/off commands twice, then test them on the equipment.

02

Route every zone

Mix Roon, external IR and disabled volume, each with its own ring step and optional Power/Mute controls.

03

BLE nearby, Wi-Fi farther away

BLE remains preferred while healthy; authenticated Wi-Fi extends reach and avoids slow firmware transfer.

04

Completely optional

Switch Bridge & Bluetooth off and restart: no Bluetooth, scans, Bridge traffic or Bridge update checks start.

Per-zone Roon, external infrared and disabled volume routing with fictional zones
Independent per-zone paths. A single RoonPilot can control native endpoints and different IR devices without pretending that infrared reports an absolute volume.
Learned infrared profile with volume, mute and separate power commands
Reusable equipment profiles. RoonPilot stores each named profile independently and automatically deploys it to the assigned Bridge when a route is saved.
Signed IR Bridge online update managed by RoonPilot
No second update tool. RoonPilot announces, verifies and transfers the Bridge release; installation remains manual and the Bridge verifies the image again.

No server bridge. No Raspberry Pi. No additional service.

RoonPilot talks directly to Roon on your local network. The optional IR Bridge is hardware control at the equipment—not a required host or cloud service.

08

One precisely supported module

RoonPilot targets the Waveshare ESP32-S3-Knob-Touch-LCD-1.8, not a generic round ESP32 display.

Main processor
ESP32-S3R8 · 16 MB flash · 8 MB PSRAM
Display
1.8-inch round IPS LCD · 360 × 360 · capacitive touch
Controls
Full rotary ring plus touch gestures
Companion
ESP32-U4WDH · independent 4 MB flash
Onboard hardware
PCM5100A DAC, microphone, vibration motor and microSD
Power
USB-C or optional internal 3.7 V / 800 mAh battery

Looking for the device? Choose the exact Waveshare model; blue and black variants come with or without a battery. Marketplace listings do not guarantee local dispatch.

10

Everything you need, explained

Start with the guide for your computer. Explore groups, Bridges and printable accessories when you need them.

USB trouble or recovery?

Use BOOT/RESET only when automatic USB connection fails. Never rotate the plug and flash the second processor as a troubleshooting guess.

Open recovery guide

Return to RoonPilot 1.0.2

If 2.0.2 does not work for you, use the fixed 1.0.2 USB recovery. It erases RoonPilot settings and profiles. Keep backups separate and do not run battery calibration under 1.0.2. Read the full instructions.

Read recovery instructions