Skip to content

kai9987kai/AUX-Generator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AUX — Advanced Shepard Tone, Beat & Noise Generator

AUX is a single-file Web Audio experiment for generating Shepard tones, beats, coloured noise, research-inspired pulse layers, procedural soundscapes, and live visual feedback directly in the browser.

It began as a simple Shepard tone, beat, and white noise generator, then expanded into a full experimental audio lab with a modern interface, sequencer, mixer, visualizer, presets, recording, soundscape generation, and adaptive perception tools.


Features

Core Audio Tools

  • Shepard tone generator
  • Rising, falling, and pulsing Shepard illusion modes
  • Adjustable base frequency
  • Adjustable Shepard speed
  • Adjustable tone layer count
  • Sine, triangle, sawtooth, and square wave modes
  • Stereo motion and detune spread

Beat Engine

  • Built-in 4-part drum system:
    • Kick
    • Snare
    • Hi-hat
    • Zap
  • 16-step sequencer
  • Click-to-toggle pattern grid
  • Classic, techno, breaks, minimal, and random pattern modes
  • Swing control
  • Micro-humanize control
  • Beat frequency and tempo controls
  • Keyboard drum pads

Noise & Texture

  • White noise
  • Pink noise
  • Brown noise
  • Digital crackle
  • Noise volume control
  • Noise filter control
  • Noise resonance control
  • Rhythmic noise gate
  • Sub drone blend

Mixer & FX

  • Master volume
  • Master low-pass filter
  • Delay / echo
  • Reverb
  • Limiter drive
  • Smooth parameter changes
  • Output level meter
  • Spectrum visualizer
  • Oscilloscope display

Research Lab

  • Research-inspired binaural layer
  • Isochronic-style pulse depth
  • Theta-style slow pulse
  • Alpha-style focus pulse
  • Beta-style alert pulse
  • Gamma-style bright pulse
  • Macro spectral motion
  • Spatial orbit
  • Generative complexity
  • Pattern mutation
  • Adaptive ducking
  • Safety fade timer
  • Emergency fade stop

These modes are experimental sound-design tools, not medical or therapeutic treatment.

Perception Lab

  • Procedural soundscape engine
  • Micro Rain
  • Slow Ocean
  • Digital Forest
  • Soft Fire
  • Synthetic Lab
  • Soundscape volume
  • Event density
  • Spectral tilt
  • Adaptive brightness
  • Comfort ceiling
  • Snapshot capture
  • Snapshot morphing
  • Markov rhythm evolution
  • Chime root and scale controls
  • Breath modulation controls
  • Scene drift
  • Auto evolve controls

Presets

Included presets:

  • Focus Spiral
  • Hypno Engine
  • Rave Machine
  • Storm Room
  • Deep Work Grid
  • Spatial Bloom
  • Rain Focus
  • Aurora Lab

Patch System

  • Save patch to browser local storage
  • Load saved patch
  • Export patch as JSON
  • Import patch from JSON
  • Name custom patches

Recording

  • Browser-based audio recording
  • Download recorded performance as .webm

Keyboard Shortcuts

Key Action
Space Start / stop all active audio
1 Trigger kick
2 Trigger snare
3 Trigger hi-hat
4 Trigger zap
R Randomize properties
S Save patch
E Evolve pattern
M Morph calm
G Toggle soundscape
A Auto balance
X Auto evolve

How to Use

  1. Download or copy the HTML file.
  2. Open it in a modern browser.
  3. Click Start All or start individual modules.
  4. Adjust the sliders and selectors in each tab.
  5. Use the sequencer to create patterns.
  6. Use presets as starting points.
  7. Save or export patches when you find a sound you like.
  8. Use Record to capture a browser recording.

Browser Requirements

AUX uses the Web Audio API and works best in modern desktop browsers such as:

  • Chrome
  • Edge
  • Firefox
  • Safari

Audio will not begin until the user clicks a button because browsers block autoplay audio by default.


Main Tabs

Shepard Tone

Controls the Shepard illusion engine, including tone direction, wave shape, stereo width, detune, speed, layers, and base frequency.

Beat Sequencer

Controls drum sounds, tempo, swing, humanization, and the 16-step pattern editor.

Noise & Texture

Controls coloured noise, filtering, resonance, rhythmic gating, and sub drone blending.

Mixer / FX

Controls the master output, low-pass filter, delay, reverb, and limiter drive.

Research Lab

Adds binaural-style and isochronic-style sound layers, spatial orbit, mutation, generative rhythm tools, and safety controls.

Perception Lab

Adds adaptive soundscape tools, procedural ambience, spectral shaping, comfort ceiling, snapshot morphing, and auto-evolution controls.


Safety Notes

Use low volume when starting.

Shepard tones, pulsing tones, drones, binaural-style layers, and noise textures can feel intense, especially through headphones. Use the safety fade timer and emergency fade if needed.

This project is for creative audio experimentation only. It is not intended to diagnose, treat, cure, or prevent any medical condition.


File Structure

This project is currently built as a single self-contained HTML file:

index.html

About

AUX is a single-file Web Audio experiment for generating Shepard tones, beats, coloured noise, research-inspired pulse layers, procedural soundscapes, and live visual feedback directly in the browser.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages