1m2lab/pipedal-distro

Fork 0

PiPedal Linux is an embedded Linux distribution designed to run the excellent PiPedal LV2 pedalboard host on dedicated hardware. It provides a reproducible build system and a ready-to-flash appliance OS for real-time guitar and audio processing. https://1m2lab.engineer/2026/03/15/pipedal-linux-by-1m2lab-building-an-embedded-audio-appliance-platform/

Shell 100%

Find a file

1m2lab ea9f7bcf80 Removed oversized ascii art from MOTD. Fixing method to parse SSID parameters to present in MOTD		2026-03-15 19:51:38 +02:00
.forgejo/workflows	release: add image identity and release pipeline	2026-03-13 01:10:40 +02:00
armbian/userpatches	Documentation rewrite, MIT license, distro branding, MOTD system	2026-03-15 15:41:03 +02:00
board-support	PiPedal appliance tuning	2026-03-13 14:03:00 +02:00
configs	Fix PiPedal installer and LV2 plugin bundle pipeline	2026-03-15 02:22:56 +02:00
docs	Documentation rewrite, MIT license, distro branding, MOTD system	2026-03-15 15:41:03 +02:00
packages	Fix PiPedal installer and LV2 plugin bundle pipeline	2026-03-15 02:22:56 +02:00
packages-products	Documentation rewrite, MIT license, distro branding, MOTD system	2026-03-15 15:41:03 +02:00
provisioning	Removed oversized ascii art from MOTD. Fixing method to parse SSID parameters to present in MOTD	2026-03-15 19:51:38 +02:00
scripts	release: add image identity and release pipeline	2026-03-13 01:10:40 +02:00
snippets	Documentation rewrite, MIT license, distro branding, MOTD system	2026-03-15 15:41:03 +02:00
.gitignore	release: add image identity and release pipeline	2026-03-13 01:10:40 +02:00
build.sh	Documentation rewrite, MIT license, distro branding, MOTD system	2026-03-15 15:41:03 +02:00
LICENSE.md	Documentation rewrite, MIT license, distro branding, MOTD system	2026-03-15 15:41:03 +02:00
README.md	Add final README with PiPedal upstream acknowledgement and project overview	2026-03-15 15:54:28 +02:00
VERSION	release: add image identity and release pipeline	2026-03-13 01:10:40 +02:00

README.md

PiPedal Linux by 1m2lab

PiPedal Linux is an embedded Linux distribution designed to run the excellent PiPedal LV2 pedalboard host on dedicated hardware.

It provides a reproducible build system and a ready-to-flash appliance OS for real-time guitar and audio processing.

Upstream Project

This distribution is built to run the excellent PiPedal project.

https://github.com/rerdavies/pipedal

Huge thanks to David R. Davies and all contributors for building an amazing open-source LV2 pedalboard environment.

PiPedal Linux aims to provide a stable embedded platform for running PiPedal as a dedicated audio appliance.

Features

• Armbian-based embedded Linux distribution
• LV2 plugin ecosystem
• Real-time audio optimizations
• Automatic first-boot provisioning
• Appliance-style system configuration
• Web-based pedalboard UI

Architecture

Hardware
   ↓
Armbian Linux
   ↓
Audio stack (ALSA / JACK / PipeWire)
   ↓
PiPedal
   ↓
LV2 Plugins
   ↓
Hardware UI (SATBUS / Widowmaker)

MOTD Dashboard

PiPedal Linux includes a custom login dashboard displaying:

PiPedal service status
Web UI address
system load
temperature
plugin information
audio device configuration

This makes the system behave like a dedicated audio appliance.

Quick Start

Clone the repository:

git clone git@anubis.1m2lab.engineer:1m2lab/pipedal-distro.git
cd pipedal-distro

Build an image:

./build.sh image beagley-ai

Images appear in:

~/armbian/build/output/images/

Supported Hardware

Current target:

• BeagleY-AI

Future targets may include:

• Raspberry Pi
• Rockchip SBC
• x86 mini PCs