How jmainguy/roland-capture-linux works
This repository provides Linux OCTA/QUAD-CAPTURE audio-device control: a native desktop panel and an octa CLI share device-support code. The main workflow discovers and identifies a device, reads its state, then applies validated control or sample-rate changes and verifies hardware readback; rate changes also coordinate PipeWire. Presets, diagnostics, meters, and QUAD-specific controls are additional product branches. Some UI and subsystem implementations were not sampled, so their links are omitted or marked unverified rather than inferred.
Main entry points: state.rs Device snapshot · control.rs Rate orchestration · octa-control.rs Control panel · mixer.rs OCTA mixer
Components 22
User interfaces
- Control panel
src/bin/octa-control.rs - octa CLI
src/main.rs
Device access
- Device discovery
src/identity.rs - ALSA discovery
src/alsa.rs - Device identity
src/device.rs - Kernel controls
src/kernel_mixer.rs - USB rate access
src/usb_rate.rs - SysEx transport
src/sysex.rs - Control MIDI
src/seq_midi.rs
Control and state
- Device snapshot
src/state.rs - Settings model
src/model.rs - OCTA mixer
src/mixer.rs - QUAD controls
src/quad.rs - Preset validation
src/preset.rs - Preset application
src/preset_apply.rs - Rate orchestration
src/control.rs
Audio and support
- Diagnostics
src/diagnostics.rs - Input meters
src/meter.rs - PipeWire sync
src/pipewire.rs
Other components
- Operator
- Capture hardware
- PipeWire services
Connections 32
- Operator → Control panel: operates
README.md - Operator → octa CLI: runs
README.md - Control panel → Device snapshot: refreshes
- Control panel → Preset validation: imports presets
README.md - Control panel → Preset application: applies settings
README.md - Control panel → Diagnostics: exports diagnostics
README.md - Device discovery → Device identity: identifies
src/identity.rs - ALSA discovery → Device identity: uses identifiers
src/alsa.rs - Device snapshot → ALSA discovery: finds card
src/state.rs - Device snapshot → Device discovery: enumerates devices
src/state.rs - Device snapshot → OCTA mixer: reads mixer
src/state.rs - Device snapshot → Kernel controls: reads controls
src/state.rs - Device snapshot → QUAD controls: reads QUAD state
src/state.rs - Device snapshot → USB rate access: reads rate
src/state.rs - OCTA mixer → Kernel controls: writes controls
src/mixer.rs - OCTA mixer → Control MIDI: uses MIDI port
src/mixer.rs - OCTA mixer → Settings model: uses settings
src/mixer.rs - Preset application → Settings model: validates settings
src/preset_apply.rs - Preset application → OCTA mixer: applies mixer
src/preset_apply.rs - Diagnostics → Device snapshot: exports snapshot
src/diagnostics.rs - octa CLI → Rate orchestration: dispatches rate commands
src/main.rs - Rate orchestration → ALSA discovery: finds card
src/control.rs - Rate orchestration → Device identity: selects device
src/control.rs - Rate orchestration → PipeWire sync: coordinates audio
src/control.rs - Rate orchestration → SysEx transport: writes rate
src/control.rs - Rate orchestration → USB rate access: reads rate
src/control.rs - Kernel controls → Capture hardware: reads and writes
README.md - Control MIDI → Capture hardware: controls
- SysEx transport → Capture hardware: sets clock
src/sysex.rs - PipeWire sync → PipeWire services: configures sync
src/pipewire.rs - Device snapshot → Settings model: holds settings
src/state.rs - Input meters → Control panel: supplies readings
README.md