Gausseous
Live demo → (Chrome or Edge for video export)
A bespoke 3D Gaussian Splatting manipulator and animator for the browser.
Arbitrary per-Gaussian programmable manipulation via Spark's dyno shader-graph
system, driven by keyframes and by an audio track.
Single file, no build step, no npm install. Dependencies are CDN imports via an
importmap: three 0.180,
Spark 2.1.0, mp4-muxer 5.x.
Formerly Splatification / Splat Bench. Presets written under the old name
still load — the old splat-bench-preset format tag is accepted alongside the
current one.
Run
ES modules will not load over file:// — it must be served.
python3 -m http.server
Then open http://localhost:8000/ and click Load test asset.
Chrome or Edge is required for video export (WebCodecs VideoEncoder).
Because the whole app is one cached HTML file, use a hard reload (Cmd+Shift+R)
after editing, or serve with no-store headers:
python3 -c "import http.server; H=http.server.SimpleHTTPRequestHandler; _e=H.end_headers; H.end_headers=lambda s:(s.send_header('Cache-Control','no-store'),_e(s)); http.server.test(HandlerClass=H,port=8000)"
First session
- Load a splat (drop it on the viewport, Choose file, or Load test asset).
To swap it later, use Load splat… in Scene → Splat, or drop another file.
- A Next card offers audio (Test audio loads
bandtest.wav). Loading
audio sets the timeline to the track's length and loops it.
- Press Play. To make more things move with the sound, arm a band under
Map in the transport bar and click any slider.
Dismiss the card with ×; the same things live in the transport bar.
Layout
- Transport (bottom): the scrub bar with the track's waveform behind it;
Play, the audio file, the Map band chips, the clock, Length and Render.
- Lane (above the transport): the focused parameter's keyframe curve, its
audio mapping, mask and gesture binding. The waveform is drawn faintly behind
the curve.
- Rail (right): five tabs.
| Tab | Sections |
|---|
| Scene | Splat · Camera · Transform · Opacity · Masks |
| Look | Background · Points · Lights · Colour · Depth · Optics · Film · Frame · Grain |
| Motion | Noise · Fracture · Quantise · Wave · Smear |
| Audio | Meters · Mappings |
| Export | Output · Preset · Viewport |
A tab shows a count when parameters inside it are driven by keyframes or
audio, and a dot when something is changed from its default.
Timeline length
Length in the transport bar replaces the old Duration slider (Camera) and
the Loop / “× set” controls (Audio):
- Seconds — set the length directly.
- Track × — a whole number of track lengths, so the audio loops cleanly.
This is what a first audio load picks.
- Bars — bars × beats at a BPM (typed or tapped), with a beat grid on the
lane and scrub bar and the bar.beat position on the clock. Tempo is entered
rather than detected: detection on field recordings is unreliable.
Loop repeats a track that is shorter than the timeline, in the preview, the
envelope lookup and the exported audio alike. Camera Orbit turns and the light
rig's Orbit both count per timeline loop, so whole numbers are seamless.
Preview playback uses Web Audio: the decoded track loops sample-accurately and
each timeline pass is scheduled on the audio clock ahead of time, so loops are
gapless in the preview as well as the export. While audio is playing, the
playhead follows the audio clock, so the picture cannot drift from the sound.
Audio
The file is analysed offline into band envelopes rather than sampled live, so
scrubbing, playback and export all agree. Four sources:
- Low / Mid / High — loudness in 20–200 Hz, 200 Hz–2 kHz, 2–16 kHz.
- Hit — a short pulse on each detected onset (drum, pluck, transient),
whatever its frequency. Material without clear transients gives few hits.
Mapping. Arm a band under Map (transport bar), then click any slider in
the rail — the slider does not move, it gains a coloured band tag. Click a
mapped slider again to unmap; Esc finishes. Every mapping is listed under
Audio → Mappings with its depth, smoothing and a remove button; clicking a
name jumps to the control. Depth is a fraction of the control's whole range
(negative pushes it down). Audio adds on top of the slider and any keyframes.
Smoothing presets — Punchy, Smooth, Swell, Gate — set attack, release,
gain, floor and curve together. The lane's Shape ▾ still exposes every
field, plus lag (negative lag lands an effect on the beat rather than after it).
The old way in still works: click a parameter's name to focus it in the lane
and pick a band there.
Effects
Most effects are a single dyno.dynoBlock running in one GPU pass as an
objectModifier on the SplatMesh:
This is the beginning of the README. Read the rest at the original. Read the full README ↗
