Skip to content

Repository files navigation

Wavefield

Wavefield animated demo preview

Wavefield is a browser-based cymatic audio visualizer. It listens to music, extracts frequency features, and turns them into Chladni-style modal patterns rendered as an interactive GPU field with Three.js.

Use it as a visual instrument: load a bundled sample track or your own audio, scrub the waveform, tune the modal field, switch between saved templates, and shape the final output with post-processing effects.

Features

  • Audio-driven cymatic fields with frequency analysis and modal interpolation
  • Screen and sphere projections with interactive Three.js rendering
  • Bundled sample tracks plus local audio upload
  • Waveform playback, scrubbing, and live diagnostics
  • Template presets for quickly changing the visual language
  • Post-processing controls for bloom, fisheye, pixelation, contouring, and trails

Showcase

The template names below use the corresponding showcase/ image filename.

Template Preview
default default template preview
microsoft-excel microsoft-excel template preview
infection infection template preview
alien alien template preview
knicks knicks template preview
lightning lightning template preview
grid grid template preview
matrix matrix template preview
diablo diablo template preview
green-flame green-flame template preview
black-on-red black-on-red template preview

Run Locally

npm install
npm run dev

Build and preview the production bundle:

npm run build
npm run preview

Templates And Audio

Wavefield loads templates from src/templates/. In development, the app can save, resave, and delete templates through the local Vite middleware.

Sample MP3 files live in src/fixtures/audio/. They are imported through Vite so production builds receive fingerprinted asset URLs instead of hardcoded file paths.

Demo Audio

Demo Audio thanks to Moby at mobygratis.com

Tests

npm run build
npm run test:analysis

License

MIT

About

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages