Siryu6/OpenRig

Contribute to Siryu6/OpenRig development by creating an account on GitHub.

Summary

OpenRig is a Rust-based open source guitar pedalboard that turns a Raspberry Pi 5 or x86_64 mini PC into a standalone multi-effects unit. It ships as a bootable OS image with a touch UI, runs audio in real time through JACK, and supports Neural Amp Modeler captures, impulse responses, and LV2 plugins. The maintainers flag it as a young project where rough edges should be expected.

What it is useful for

OpenRig is for guitarists and audio engineers who want a self-hosted, DIY multi-effects rig rather than a commercial pedalboard or a laptop-based setup. The signal chain is built around a Rack view with serial blocks plus A/B, Mix, and left/right splits, in mono or stereo, and integrates NAM captures and IRs as built-in blocks alongside any compatible LV2 plugin. The TONE3000 integration lets users link an account and download captures on the device itself, with credits and licenses preserved. For live work it offers 8 scenes per preset, setlists, stomp mode, tap tempo, a tuner and looper, and a Helix-style MIDI mapping with clock and CC learn. System updates are signed A/B partitions that automatically roll back if the new image fails to boot.

How engineers can use it

The README describes two paths. For quick experimentation, download openrig-<version>-linux-x86_64.tar.gz (or aarch64) from the releases, install jackd2 and liblilv-0-0 via apt, start JACK, then run ./pedalboard; the UI starts even with audio disabled. For the full rig, flash openrig-os-<version>-rpi5.img.xz or the x86_64 image to an SD card or disk using Raspberry Pi Imager, dd, or balenaEtcher, then attach a class-compliant USB audio interface and a touchscreen; footswitches and a MIDI pedal are optional. Building from source needs the Debian/Raspberry Pi OS packages listed in the README, git submodule update --init --recursive for the NeuralAudio submodule, then Cargo. Feature flags such as gpio, kms, lv2, nam, midi, and tone3000 control what is compiled in; the Pi image uses --features kms,lv2,nam,tone3000,midi,gpio,splash,update. Environment variables like PEDALBOARD_DATA_DIR, PEDALBOARD_FOOTSWITCH_PINS, and PEDALBOARD_ENCODER_PINS customize data location and hardware wiring without recompiling. Because the project is explicitly marked young, contributors should expect rough edges and report them; current status lives in PROJECT_STATUS.md and feature internals in docs/FEATURES.md.