| name | orklev2-pipewire |
| description | Answer questions about orkid's PipeWire audio backend (Linux), SPA buffer processing, pw_stream callback, CPU load tracking, and how PipeWire drives the Singularity synth. Use when the user asks about PipeWire or modern Linux audio. |
| user-invocable | false |
Orkid PipeWire Backend Reference
When answering questions about the PipeWire audio backend in orkid, consult the files below. All under ork.lev2/.
Key Files
| Component | File |
|---|
| AudioDevice Base | inc/ork/lev2/aud/audiodevice.h |
| AudioDevicePipeWire | src/aud/pipewire/audiodevice_pipewire.h |
| Implementation | src/aud/pipewire/audiodevice_pipewire.cpp |
| Config Flags | inc/ork/lev2/config.h (ENABLE_PIPEWIRE, Linux only) |
Architecture
PipeWire stream callback model:
PipeWire Main Loop Thread (on_pw_process)
├─ Dequeue SPA buffer from pw_stream
├─ synth->compute(num_frames, input_buffer)
├─ Interleave L/R floats → output buffer
├─ Compute CPU load percentage
└─ Re-queue buffer
PrivateImplementation
| Member | Description |
|---|
_synth | Singularity synth instance |
_audioThread / _synthThread | Processing threads |
_pipewire_stream | pw_stream* handle |
_pipewire_main_loop | pw_main_loop* |
_spa_buffer | SPA buffer for output |
_input_buffer | Float input buffer (2048 samples) |
_timer | CPU load timing |
Process Callback (on_pw_process)
- Dequeue buffer from PipeWire stream
- Calculate frames:
num_frames = maxsize / stride
synth->compute(num_frames, _input_buffer)- Interleave
_obuf._leftBuffer / _rightBuffer → output
- Compute CPU load as percentage
- Re-queue buffer
Configuration
| Parameter | Value |
|---|
| Format | Interleaved float (32-bit) |
| Channels | 2 (stereo) |
| Sample Rate | 48000 Hz |
| Frames/Buffer | 256 (DESIRED_NUMFRAMES) |
How to Answer
- For PipeWire device: check
audiodevice_pipewire.h and .cpp
- For base interface: check
audiodevice.h
- For Singularity integration: consult orklev2-audio skill
