Pipedal
Guitar Effect Pedal for Raspberry Pi, with a web interface designed specifically for phones.
Download: v2.0.105 Website: [https://rerdavies.github.io/pipedal](https://rerdavies.github.io/pipedal). Documentation: [https://rerdavies.github.io/pipedal/Documentation.html](https://rerdavies.github.io/pipedal/Documentation.html). The project is written primarily in C++, distributed under the Other license, first published in 2021. Key topics include: lv2-host, lv2-plugin, music, raspberry-pi, raspberry-pi-4.
<img src='docs/GithubBanner.png' width="100%" /><br/>
<a href="https://rerdavies.github.io/pipedal/ReleaseNotes"><img src="https://img.shields.io/github/v/release/rerdavies/pipedal?color=%23808080"/></a>
<a href="https://rerdavies.github.io/pipedal/download"><img src="https://img.shields.io/badge/Download-008060" /></a>
<a href="https://rerdavies.github.io/pipedal/Documentation"><img src="https://img.shields.io/badge/Docmentation-0060d0"/></a>
<a href="https://rerdavies.github.io/pipedal/LicensePiPedal.html"><img src="https://img.shields.io/badge/MIT-MIT?label=license&color=%23808080"/></a>
<a href="https://github.com/rerdavies/pipedal/actions"><img src="https://img.shields.io/github/actions/workflow/status/rerdavies/pipedal/cmake.yml?branch=main"/></a>
<img src="https://img.shields.io/github/downloads/rerdavies/pipedal/total?color=%23808080&link=https%3A%2F%2Frerdavies.github.io%2Fpipedal%2Fdownload.html"/>
Download: <a href='https://rerdavies.github.io/pipedal/download.html'>v2.0.105</a>
Website: https://rerdavies.github.io/pipedal.
Documentation: https://rerdavies.github.io/pipedal/Documentation.html.
Announcing PiPedal 2.0 (2.0.105)—a major update to PiPedal, including exciting new features. See the Pipedal website documentation for more information.
Use your Raspberry Pi, or Ubuntu amd/x86-64 computer as a guitar effects pedal. Configure and control PiPedal remotedly, with your phone or tablet, or via a web browser.
PiPedal running on a Raspberry Pi 4 or Pi 5 provides stable super-low-latency audio via external USB audio devices, or internal Raspberry Pi audio hats.
PiPedal runs on Raspbery Pi OS (Bookworm or Trixie), or Ubuntu 24.x or later (amd64/x86-64 and aarch64). Make sure you follow the Ubuntu post-install
instructions to make sure your Ubuntu OS is using a realtime-capable kernel.
<img src="docs/gallery/dark-sshot1.png"></img>
<img src="docs/gallery/nam_models.png" width="45%"></img> <img src="docs/gallery/hotspot.png" width="45%"></img> <img src="docs/gallery/tuner.png" width="45%"></img><img src="docs/gallery/rig.jpg" width="45%"></img>
https://github.com/user-attachments/assets/6ff585ff-69fa-4b54-8009-50ad071e328e
New in PiPedal v2.0:
- Support for Neural Amp Modeler (NAM) A2 models.
- Direct single-step downloads of NAM A2 models to the Pipedal server using web services provided by <a href="https://tone3000.com/">Tone3000.com</a>.
- Install PiPedal as a Progressive Web App (PWA) on your Windows or Apple desktop or laptop in order to run PiPedal as a native application, without the clutter of browser chrome, address bars, and needless decorations.
- A new Channel Routing dialog which allows you to pass through Auxilliary audio channels, or unprocessed guitar inputs for later re-amping in a DAW or external hardware.
- New NAM A2-based Factory Presets, and a small selection of NAM A2 models pre-installed and ready to use.
PiPedal includes state-of-the-art AI-based guitar amp emulation, using the TooB Neural Amp Modeler technology. And PiPedal 2.0 now includes support for the brand new NAM A2 technology, which provides event more accurate amp simulations than NAM A1, while using even less CPU. Experience the ground-breaking quality of NAM A2 models now, with PiPedal's low-latency audio engine running on your Raspberry Pi or Ubuntu computer.
NAM changes everything! Simulations that not only sound like the real thing, but also respond to your playing dynamics in the same way as the real amp. NAM amp simulations are demonstrably and measurably better than amp simulations from competing commercial vendors.

PiPedal 2.0 integrates with Tone3000.com's web services, allowing you to directly install new NAM A2 models on the pipedal server without ever leaving the PiPedal user interface. Or download and install commercially-developed NAM models from a rich ecosystem of model providers.
PiPedal can be remotely controlled via a web interface over Ethernet, or Wi-Fi. If you don't have access to a Wi-Fi router, PiPedal can be configured to
start a Wi-Fi hotspot automatically, whenever your Raspberry Pi can't connect to your home network.
Install the PiPedal Remote Android app to get one-click access to PiPedal via Wi-Fi networks, or Wi-Fi hotspots. If you are using PiPedal away from home, you can configure PiPedal to automatically start a Wi-Fi hotspot whenever Pipedal is unable to detect your home network (Raspberry Pi OS only). The PiPedal Client Android app will allow to connect by simply launching the app, whether you are at home, or using a Wi-Fi auto-hotspot at a gig, when away from home.
PiPedal's user interface has been specifically designed to work well on small form-factor touch devices like phones or tablets. Clip a phone or tablet on your microphone stand on stage, and you're ready to play! Or connect via a desktop browser, for a slightly more luxurious experience. The PiPedal user-interface adapts to the screen size and orientation of your device, providing easy control of your guitar effects across a broad variety devices and screen sizes.
PiPedal includes a pre-installed selection of LV2 plugins from the ToobAmp collection of plugins; but it works with most LV2 Audio plugins. There are literally hundreds of free high-quality LV2 audio plugins that will work with PiPedal. Just install them on your Raspberry Pi, and they will show up in PiPedal.
If your USB audio adapter has MIDI connectors, you can use MIDI devices (keyboards, controllers, or midi floor boards) to control PiPedal while performing. A simple interface allows you to select how you would like to bind PiPedal controls to midi messages.
System Requirements
Installing PiPedal
Installing PiPedal on Ubuntu
Headless Operation
Configuring PiPedal After Installation
What PiPedal Is
Machine Learning in PiPedal (A History)
How to Use PiPedal
How to Build Presets With PiPedal
An Intro to Snapshots
Neural Amp Modeler Calibration
Choosing a USB Audio Adapter
Optimizing Audio Latency
Command-Line Configuration of PiPedal
Changing the Web Server Port
Using LV2 Audio Plugins
Which LV2 Plugins does PiPedal support?
LV2 Plugins with MOD User Interfaces
Frequently Asked Questions
Building PiPedal from Source
Build Prerequisites
The Build Systems
How to Debug PiPedal
PiPedal Architecture
<hr style="margin-top: 32px; margin-left: 32px; width: 50%;" /> <p id="fn1" style="margin-left: 32px; margin-right: 32px; font-size: 0.8em;"> <sup><a href="#fnref1" aria-label="Back to figure note reference">1</a></sup> TONE3000, & Atkinson, S. (2026). <em>A2 MUSHRA Listening Test Raw Data</em> [Data set]. Tone3000. <a href="https://www.tone3000.com/guides/nam-a2-the-complete-guide" target="_blank" rel="noreferrer"> https://www.tone3000.com/guides/nam-a2-the-complete-guide </a> . Repository: <a href="https://github.com/tone-3000/a2-mushra-data" target="_blank" rel="noreferrer"> https://github.com/tone-3000/a2-mushra-data </a> . License: CC BY 4.0. <a href="#fnref1" aria-label="Back to figure note reference">↩</a> </p>
Contributors
Showing top 8 contributors by commit count.
