Helrig BoxOverviewInstallGuideSetupCaseDevelopers

Helrig Box

A small box that puts your Helix or HX pedal on your Wi-Fi, so Helrig can edit it without a cable to your computer.

The finished Helrig Box: a small black 3D-printed case with the four-colour Helrig symbol on top and HELRIG in white on the side

Helrig on your computer, connected over Wi-Fi to the Helrig Box, connected by USB to your Helix or HX pedal

The pedal plugs into the box by USB. The box joins your Wi-Fi. Helrig finds it and edits the pedal as it would over a cable. The box only passes the pedal's USB signal along. It never reads or changes your presets.

Tried so far with a Helix LT and an HX Stomp. Connecting to a pedal in Helrig needs Helrig Connect or Helrig Pro.

Watch the Helrig Box video on YouTube.

Get one running

  1. Get the parts. A Waveshare ESP32-P4-NANO board (wiki), a USB-C cable that carries data, a USB-C power source, and the USB cable you use to connect your pedal to a computer. A 3D-printable case is optional. Full list.
  2. Install the firmware from your browser (desktop Chrome or Edge), with nothing to install: box.helrig.com/flash. It takes about 2 minutes. Step by step, drivers and troubleshooting.
  3. Set it up. On your phone, join the Wi-Fi network the box makes. It is called Helrig Box plus six characters. Open http://192.168.4.1 and pick your home Wi-Fi. Setup and factory reset.
  4. Use it. Plug your pedal into the box's USB-A port, open Helrig, and pick the box in the device menu. The first time, press Pair in Helrig, then press BOOT on the board once.

The box works on 2.4 GHz Wi-Fi only. It remembers up to three networks, so home, the rehearsal room and your phone's hotspot can all work. Each computer or tablet pairs with the box once, by pressing the BOOT button on the board. Pairing needs Helrig 1.5.3 or later. It does not encrypt the traffic, so use the box on a network you trust.

Questions and problems

Check Troubleshooting first. If that does not help, open an issue and say which pedal, which computer and browser, and what the page or the box did.

For developers

The firmware is ToneRelay, an open-source Wi-Fi relay for Helix pedals by Mark Peskett, built with a small Helrig Box profile (its names, setup page and defaults). This repository holds that profile, the web flasher and the docs. How it fits together · Build from source · Releasing · What has been measured

Licence

The code and docs are MIT (LICENSE). The Helrig name, the Helrig Box logo and the icon are Helrig's and are not covered by it; see NOTICE.md, which also lists the other software used. Helrig and the Helrig Box are not affiliated with Line 6 or Yamaha Guitar Group.