Repository navigation
Conversation
Reports each channel's click onsets against the nearest beat (ms, from the buffer's begin beat on the probe's own session timeline), so a publisher's stamping can be checked without a DAW. Used to validate the VCV Rack modules' clock edges and Send/Receive stamp alignment. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
A VCV Rack 2 plugin ("Most Distant", rack/) that makes Rack a Link Audio
citizen. Each module is its own LAN Link (Audio) peer compiled against
plugins/wail_link, like WAIL Send / WAIL Receive (ADR-0007).
- Link Clock: Link timeline β clock / bar reset / run CV, sample-accurate
(edges measured β0.04 ms off the beat), optional gate by Link transport.
- Link Audio Send: publishes a Rack stereo input (engine rate β 48 kHz,
converter delay compensated), stamped at play time; nameable channel.
- Link Audio Receive: plays one channel (Auto = first WAIL room channel),
aligned to its beat stamps; adaptive max-hold delay for late LAN channels.
- Link Audio Receive 16: every WAIL room stream at once β 16 named stereo
slots that fill themselves (RoomSlots, a port of WAIL Receive's id-keyed
slot manager) plus polyphonic L/R outputs.
Rack renders in bursts with no host transport, so FrameClock maps engine
frames to Link time from block-start observations; nothing on the audio
thread allocates (new lb_state_create / lb_capture_into / lb_source_pop_at /
lb_state_tempo in wail_link, plus the start/stop calls Link Clock needs).
Pure logic (FrameClock, StampAligner, RoomSlots) has 27 host-compiled unit
tests (`make test`).
Also a packaging spike toward the WAIL client inside Rack:
wail-app/cmd/wailcore built with -buildmode=c-archive and linked into the
plugin as one binary, driven by a placeholder WAIL module. Verified in
headless Rack on macOS arm64; links for Windows (MinGW), unrun; Linux
untested.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
A VCV Rack 2 plugin (
rack/, "Most Distant") that makes Rack a Link Audio citizen. Every module is its own LAN Link (Audio) peer built onplugins/wail_link, the same pattern as WAIL Send / WAIL Receive (ADR-0007). The WAIL app is unchanged.WAIL Β·room channel), aligned to its beat stamps.Design notes (details in
rack/README.md,docs/architecture.md, and a newtradeoffs.mdentry):FrameClockmaps engine frames to Link Β΅s from block-start observations; stamps, clock edges and playout all use play time.RoomSlotsis a port of WAIL Receive's id-keyed slot manager;RecvSlotis shared playout.wail_linkgainslb_state_create,lb_capture_into,lb_source_pop_atandlb_state_tempo, plus the start/stop calls Link Clock needs. The CLAP plugins' existing calls are unchanged.Also included:
linkaudio-probe -onsets: click-onset phase vs the beat grid, for checking stamping without a DAW.wail-app/cmd/wailcore: the Go client built as a C static archive and linked into the plugin as one binary, behind a placeholder WAIL module. Groundwork for running the WAIL client inside Rack; there's no session yet.Test results
make testinrack/, 27/27 pass (FrameClock, StampAligner, RoomSlots).go test ./cmd/wailcorepasses.linkaudio-probe -onsets):go test ./...passes,go test -tags linkstub ./...passes,./scripts/tier2-e2e.shpasses (7 placement checks, 0 failures), and the CLAP plugin ctest passes.Known gaps
kDeviceLatencyUs(5 ms) hasn't been checked against a real device.abllinkcopy pluswail_link. A test link showed macOS silently resolves the Go side to the plugin's copy. The plugin needs a single Link owner before the engine moves in.π€ Generated with Claude Code