Nodes/ComfyUI-SweepGrid/Audio Waveform Player
ComfyUI Node

Audio Waveform Player

Audition every audio result in your sweep without leaving the canvas

By embedding-shapes·Created about a month ago·Updated about a month ago· 3
Audio Waveform Player
  • audio
    label

    The video side of SweepGrid gets the glory, but the pack's audio story is quietly the cleverest part. If your workflow produces an AUDIO output once per sweep result - a music model, a voice, a sound design run - you normally get a pile of previews you open one at a time and mentally compare. Audio Waveform Player collects every mapped audio result in sweep order and shows them as a stack of waveforms in a single node, with one browser audio player you can click to seek and audition any of them. Same story as the video grid, but for your ears.

    How it works

    The required audio input is just the ordinary AUDIO output from your generation path, produced once per sweep result. Because SweepGrid runs on ComfyUI list execution, the node receives the mapped results in sweep order - no list-building node, no custom audio type. The optional label input takes the same string each result was tagged with (the pack's pattern is to reuse the Format Text output that feeds your video overlays), and it's displayed as a clickable caption per waveform.

    Visually it's a vertical list of horizontal waveforms sharing one time axis: all rows use the longest clip as their width and the largest peak as their amplitude scale, so duration and raw level differences are visible at a glance. Click a waveform to select it and seek to the clicked time; click a label to play that result from the start. Normalize waveforms rescales each drawing independently for inspecting quieter shapes - it never touches the audio sent to playback. Only one source plays at a time.

    Two deeper features. It creates temporary FLAC previews through ComfyUI's native audio preview helper, so no new media player machinery. And Sync video preview ties play, pause, seeking, and loop to exactly one Save Video that's fed directly by Build Streaming Video Grid (or by Build Video Grid through Create Video) - the waveform player and the video preview drive each other, with the shorter duration as the shared range. It's browser audition synchronization, not sample-accurate analysis, and it auto-disables if the eligible Save Video path becomes missing or ambiguous.

    Validation, or: what it refuses to do

    The node validates hard rather than silently mangling: each input must be a mono or stereo [1, channels, samples] waveform with a positive integer sample rate, and it rejects audio batches, mismatched label counts, empty audio, unsupported channel counts, and more than 100 results. There's no graph output - it's a terminal preview node.

    Install

    Shared pack drill: ComfyUI Manager → "ComfyUI-SweepGrid" → Install, restart; needs ComfyUI 0.31.0+. No extra dependencies - the FLAC preview path uses ComfyUI's own helpers.

    CategorySweepGrid

    Inputs (2)

    NameTypeDefaultDescription
    audioAUDIOMapped audio results to preview.
    labeloptSTRINGOptional label for each mapped audio result.

    Outputs (0)

    No outputs