← GitHub home

ROONPILOT · STEP-BY-STEP VIDEO GUIDE · 5:00 MINUTES

USB installation — step by step

With narration, animated clicks, and a close-up of turning over the USB-C connector. Pause whenever you need to and try each step at your own pace.

Open the RoonPilot project page

A step-by-step guide, even if you have never used an ESP32 before.

Chapter 1 · Introduction

For a larger view, choose the full-screen icon at the bottom right of the video. On a phone, landscape orientation is easier to read.

Jump straight to a step

This guide shows the USB installer for 2.0.2. Always choose the current USB version on the installation page. Progress is shortened for the video. Device selection, the USB close-up, and Roon authorisation are illustrated examples. The installer dialogs and Wi-Fi form show the actual interface.

Read all the steps
  1. Install RoonPilot in your browser

    Here is how to install RoonPilot directly in your browser. We will go through every click together, including how to connect the correct USB device.

  2. What you need

    You need your RoonPilot, a USB data cable, and Chrome or Edge on a computer. A charging-only cable will not work. Connect the device directly to your computer.

  3. Existing settings will be erased

    This installation erases the existing settings on RoonPilot. If you still need them, save a configuration backup first. If your device is brand new, you can continue straight away.

  4. Open the official installation page

    Open Chrome or Edge. Enter the address shown here in the address bar, then press Enter. This takes you to the official RoonPilot installer.

  5. Use the current USB version

    Scroll down to Choose firmware. Leave the current USB version selected. In this example, it is version two point zero point two. A newer version may be available later.

  6. Read the notices and open the installer

    Scroll down a little further. Read the notices about the correct processor, erasing the device, and the licence. Tick both boxes. You can now click Install RoonPilot.

  7. How to recognise the correct USB device

    The device name is what matters, not the number in brackets. The entry highlighted in green is correct. If you already see it, connect directly. The next steps are only needed if USB serial appears instead.

  8. If “USB serial” is listed instead

    Sometimes the list only shows USB serial. That is the other processor inside the device. Do not select it. You only need to turn over the USB-C connector at the RoonPilot.

  9. 1. Unplug the cable at the RoonPilot

    Leave the device selection window open. Unplug the cable at the RoonPilot. Leave the other end connected to your computer. The old entry disappears from the list.

  10. 2. Turn the USB-C connector over by 180°

    Turn the unplugged connector around its own lengthwise axis, by one hundred and eighty degrees. The side that was facing upwards is now underneath. You do not need a different cable.

  11. 3. Plug it back in, select, and connect

    Plug it back into the same socket. The browser updates the list. The correct device name now appears. Click that entry, then click Connect.

  12. Choose “Install RoonPilot” in the small window

    After connecting, a small RoonPilot window opens. Click Install RoonPilot. You do not need Logs and Console for a normal installation.

  13. Confirm the erase and installation

    This window asks you to confirm the installation. The warning means that all data on the device will be erased. When you are ready, click Install.

  14. Watch the progress in your browser

    First, the installer prepares the device and erases its memory. Then the percentage increases. Keep the window visible and leave the cable connected. The actual installation may take a few minutes.

  15. “Installation complete!” — success

    Wait until you see Installation complete. Only then is the installation finished. Click Next, then close the small window. RoonPilot restarts. Leave USB connected to keep it powered.

  16. Connect to the setup Wi-Fi network

    The RoonPilot screen now shows Wi-Fi setup. Open the Wi-Fi list on your phone, tablet, or laptop. Connect to RoonPilot Setup. The last six characters identify your particular device.

  17. Stay connected to the setup network

    The password is roonpilot, a hyphen, then setup, all in lower case. If your phone reports no internet, stay connected anyway. This network is only used to set up the device.

  18. Enter and save your home Wi-Fi details

    Open your browser and enter one nine two, dot, one six eight, dot, four, dot, one. If necessary, choose English. Enter your home Wi-Fi name and password. Use a two point four gigahertz network. Click Save and restart.

  19. Enable RoonPilot in Roon

    Reconnect your phone to your home Wi-Fi. RoonPilot now searches for your running Roon Server. When it is waiting for authorisation, open Settings and Extensions in Roon. Enable RoonPilot by Senior Coder.

  20. Choose a zone — you are ready!

    Finally, choose the zone you want to control, directly on the RoonPilot screen. Once the player view appears, setup is complete. Enjoy using RoonPilot.

  21. No USB device, or the wrong ESP32?

    If no USB device appears, first check your data cable. If the installer reports that your ESP thirty-two board is not supported, turn the connector over as shown, then start the connection process again.

  22. Enjoy your RoonPilot!

    You can repeat any step using the chapters. The full written guide is available on the RoonPilot project page.