v1.1: Node audio editor via AudioMass #1

New issue

Open

opened 2026-05-26 13:09:43 -07:00 by pyr0ball · 0 comments

pyr0ball commented

2026-05-26 13:09:43 -07:00

Owner

Summary

Integrate AudioMass (MIT) to add in-node audio editing to the Sparrow studio. Currently users can generate, preview, commit, or discard a node but cannot trim, EQ, or splice a generated clip before committing it — forcing a DAW round-trip.

Integration points

Touchpoint	What it enables
Node refinement	"Open in editor" on any `ready` node — trim, EQ, normalize before committing
Chain preview	Multitrack view of committed spine nodes with crossfade control
Source prep	Edit root audio before upload

Phased approach

Add "Open in editor" button to SegmentEditor for ready nodes
Open AudioMass in a modal iframe, passing the node audio URL
On save, POST modified WAV back to a new PUT /api/nodes/{id}/audio endpoint

Phase B (embedded panel — fully integrated)

Fork AudioMass, mount waveform editor inside a "Refine" drawer in SegmentEditor
Crossfade values from chain preview feed POST /api/chains/{id}/export as optional per-node fade params

Backend changes needed (Phase A+)

PUT /api/nodes/{id}/audio — replace node audio file, reset duration_s, keep status ready
Export endpoint: optional crossfade_ms per node pair in request body

Reference

Design spec section: circuitforge-plans/sparrow/superpowers/specs/2026-04-16-sparrow-studio-design.md § Node Editor — v1.1

Found via: pkalogiros/audiomass

## Summary Integrate [AudioMass](https://github.com/pkalogiros/audiomass) (MIT) to add in-node audio editing to the Sparrow studio. Currently users can generate, preview, commit, or discard a node but cannot trim, EQ, or splice a generated clip before committing it — forcing a DAW round-trip. ## Integration points | Touchpoint | What it enables | |---|---| | **Node refinement** | "Open in editor" on any `ready` node — trim, EQ, normalize before committing | | **Chain preview** | Multitrack view of committed spine nodes with crossfade control | | **Source prep** | Edit root audio before upload | ## Phased approach ### Phase A (iframe modal — ships fast, no backend changes) - Add "Open in editor" button to `SegmentEditor` for `ready` nodes - Open AudioMass in a modal iframe, passing the node audio URL - On save, POST modified WAV back to a new `PUT /api/nodes/{id}/audio` endpoint ### Phase B (embedded panel — fully integrated) - Fork AudioMass, mount waveform editor inside a "Refine" drawer in `SegmentEditor` - Crossfade values from chain preview feed `POST /api/chains/{id}/export` as optional per-node fade params ## Backend changes needed (Phase A+) - `PUT /api/nodes/{id}/audio` — replace node audio file, reset `duration_s`, keep status `ready` - Export endpoint: optional `crossfade_ms` per node pair in request body ## Reference Design spec section: `circuitforge-plans/sparrow/superpowers/specs/2026-04-16-sparrow-studio-design.md` § Node Editor — v1.1 Found via: [pkalogiros/audiomass](https://github.com/pkalogiros/audiomass)

No labels

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: Circuit-Forge/sparrow#1

No description provided.