Initial: OPLabsBandChannel.lv2 + OPLabsBandBus.lv2

2026-06-21 00:03:37 -04:00
commit f8e697a064
68 changed files with 9591 additions and 0 deletions
@@ -0,0 +1,100 @@
+# OPLabs LV2 Plugin Collection
+
+A collection of LV2 audio plugins for band mixing, designed for PiPedal and
+any standard LV2 host.
+
+## Plugins
+
+### OPLabsBandChannel
+
+Stereo channel strip for individual instrument/voice channels.
+
+- **URI:** `http://ourpad.casa/plugins/oplabs-band-channel#`
+- **Class:** `lv2:UtilityPlugin`
+- **Controls:** Volume (-60..+6 dB), Pan, Mute, Solo, Instrument type
+- **Meters:** Peak level L/R
+- **Features:** State save/restore
+
+### OPLabsBandBus
+
+Stereo bus/group processor.
+
+- **URI:** `http://ourpad.casa/plugins/oplabs-band-bus#`
+- **Class:** `lv2:UtilityPlugin`
+- **Controls:** Volume (-60..+6 dB), Mute
+- **Meters:** Peak level L/R
+- **Features:** State save/restore
+
+## Directory Structure
+
+```
+oplabs-lv2-plugins/
+├── CMakeLists.txt                  # Top-level build
+├── README.md
+├── lv2/
+│   ├── OPLabsBandChannel.lv2/     # LV2 bundle (TTL + .so)
+│   │   ├── manifest.ttl
+│   │   ├── OPLabsBandChannel.ttl
+│   │   └── OPLabsBandChannel.so
+│   └── OPLabsBandBus.lv2/         # LV2 bundle (TTL + .so)
+│       ├── manifest.ttl
+│       ├── OPLabsBandBus.ttl
+│       └── OPLabsBandBus.so
+└── src/
+    ├── CMakeLists.txt
+    ├── OPLabsBandChannel.cpp
+    ├── OPLabsBandChannel.hpp
+    ├── OPLabsBandChannel.version
+    ├── OPLabsBandBus.cpp
+    ├── OPLabsBandBus.hpp
+    └── OPLabsBandBus.version
+```
+
+## Building
+
+```bash
+# Prerequisites
+sudo apt install build-essential cmake lv2-dev
+
+# Configure and build
+cd ~/projects/oplabs-lv2-plugins
+cmake -B build -DCMAKE_BUILD_TYPE=Release
+cmake --build build
+
+# Verify plugins
+lv2ls | grep ourpad
+lv2info http://ourpad.casa/plugins/oplabs-band-channel#
+lv2info http://ourpad.casa/plugins/oplabs-band-bus#
+```
+
+The `.so` files are placed directly into `lv2/OPLabsBandChannel.lv2/` and
+`lv2/OPLabsBandBus.lv2/`, making each directory a self-contained LV2 bundle.
+
+## Setup (local LV2 path)
+
+Add the plugins to your LV2 path:
+
+```bash
+export LV2_PATH="${HOME}/projects/oplabs-lv2-plugins/lv2:${LV2_PATH}"
+```
+
+Or install system-wide:
+
+```bash
+sudo cmake --install build
+```
+
+## Deploy to PiPedal
+
+```bash
+# Copy the lv2 directory to the Pi
+scp -r lv2/* pi@192.168.0.245:/home/bib/oplabs-lv2-plugins/
+
+# On the Pi, set up the LV2 path or symlink
+# ssh pi@192.168.0.245
+# export LV2_PATH="/home/bib/oplabs-lv2-plugins:$LV2_PATH"
+```
+
+## License
+
+MIT