The Baryon GUI (top-right corner) lets you shape the visualizer in real time. Hover over any control in the panel to see its tooltip. This document provides the full reference for every user-facing control, organized by folder.
For a practical walkthrough, start with First session guide. For the conceptual model behind these settings, see Understanding the engine. Desktop OSC, OSCQuery, and MIDI control-input setup lives in Parameter Automation; outbound modal-structure data lives in OSC Structure Export.
Common Tasks
| Task | Controls to use |
|---|
| Manually rotate the cymatic volume | Set Rotation Mode to Manual, then adjust Manual Rotation in Motion. |
| Keep the scene stationary | Set Rotation Mode to Off. |
| Let audio drive scene movement | Set Rotation Mode to Audio, then tune Motion Scale. |
| Change viewpoint | Use the floating camera controls or orbit drag while the camera is unlocked. |
| Prevent accidental camera movement | Enable Lock Camera. |
| Capture a still | Frame the scene, lock the camera, set rotation intentionally, then use browser or OS capture tools. |
Baryon does not currently expose keyboard shortcuts for manual cymatic
rotation. The only currently documented keyboard shortcut is fullscreen where
the host exposes it.
The mic profile selector next to the mic button exposes two analysis presets:
| Profile | Description |
|---|
| Voice | Speech and singing. Tracks a lead vocal pitch and uses harmonics as texture. |
| Ambient | Crowds, rooms, parties, and mixed music. Represents multiple simultaneous sources instead of one driver. |
Mic Settings
Controls for live-input analysis and browser microphone processing.
| Label | Description |
|---|
| Live Input Mode | Choose how unknown live devices should be analyzed. Auto uses heuristics, Line Feed uses the file-style path, and Acoustic Mic uses the mic-specific path. |
| Mic Intent | Choose how acoustic mic input should be interpreted. Ambient is forgiving for rooms and instruments; Vocal emphasizes singing and lead pitch. |
| Echo Cancel | Suppress speaker bleed and room echo from mic input. Useful with speakers, but it may color the audio spectrum. |
| Noise Suppress | Filter out steady background noise before analysis. Useful in noisy rooms, but it can soften quieter harmonics. |
| Auto Gain | Automatically normalize mic volume. Convenient for speech, but it flattens dynamics for visualization. |
Controls for render cadence, adaptive quality, and the performance HUD.
| Label | Description |
|---|
| Profile | Auto adapts raymarch steps toward 60 FPS, Custom uses Target FPS, and Max Quality leaves raymarch steps ungoverned. |
| Target FPS | Performer cadence and adaptive raymarch target used when Profile is Custom. |
| HUD | Shows FPS and render resolution on screen. |
Output
Controls for the published output mode and opaque output fill.
| Label | Description |
|---|
| Mode | Transparent composites over other content. Opaque renders solid output. |
| Output Color | Background fill color used in Opaque output mode. |
Shape
Controls for the raymarched modal volume.
| Label | Description |
|---|
| Boundary | Choose whether the modal family behaves like a reflective boundary (Neumann) or a fixed node. |
| Node Threshold | How sharp the bright ring structures appear — lower values create crisper, more defined rings. |
| Density | How thick and bright the overall volume body appears — raise for a bolder, denser orb. |
| Absorption | Depth contrast inside the orb — raise for crisper internal layers and less haze. |
| Opacity | How solid the orb appears — raise for a stronger presence, especially when compositing over video. |
| Steps | Rendering quality versus speed — higher values look smoother but may reduce frame rate on slower GPUs. |
Color
Controls for the orb color and Spectral Light transfer.
| Label | Description |
|---|
| Color Mode | Static uses the chosen colors. Spectral colors promoted cymatic modes from the audio spectrum. |
| Volume | Main volume color of the orb interior. |
| Contour | Color of the sharpest ring edges and contour highlights. |
| Color Mix | Strength of Spectral Light coloring when Color Mode is Spectral. |
| Sheen | Adds a holographic sheen to the orb’s surface edges. |
| Sheen Color | How far the sheen color shifts toward cool blue-green tones. |
| Sheen Edge | How tightly the sheen stays to the very edge — higher values confine it to a thinner rim. |
Motion
Controls for scene movement and audio reactivity.
| Label | Description |
|---|
| Rotation Mode | Audio rotates the orb with music, Manual uses Manual Rotation, and Off keeps it still. |
| Manual Rotation | Spin speed in Manual rotation mode — negative values reverse direction. |
| Motion Scale | Scales the auto-calibrated rotation in Audio mode. It has no effect in Manual rotation mode. |
| Reactivity | How strongly the visuals respond to the audio — raise for more dramatic reactions. |
Bloom
Controls for bloom and fine-grained bloom shaping.
| Label | Description |
|---|
| Bloom | Toggle the bloom or halo effect around bright parts of the orb. |
| Bloom Strength | How bright the bloom halo is. |
| Bloom Radius | How far the bloom spreads from bright areas. |
| Bloom Threshold | Minimum brightness before a region contributes to bloom — raise to limit it to the brightest highlights. |
| Bloom Response | Makes the bloom smaller and more stable by trimming how easily bloom reacts during crowded frames. |
| Rim Bloom | Pushes more brightness toward the outer rim before bloom is applied. |
| Rim Compression | Tames sharp edge spikes before they reach the bloom pass. |
Logo
Idle-state overlay controls.
| Label | Description |
|---|
| Logo Intensity | Brightness of the idle logo shown when no audio is playing. |
| Logo Size | Size of the idle logo overlay shown when no audio is playing. |
Diagnostics
Diagnostic controls help isolate render, audio, and analysis behavior. Debug-only controls require devtools (DEVTOOLS_ENABLED).
| Label | Description |
|---|
| TRAA | Toggle temporal anti-aliasing for diagnostics when isolating render latency, shimmer, or post-process cost. |
| Capture Debug Data | Record per-frame debug data for the active analysis and renderer. |
| Freeze Pattern | Hold the current modal pattern in place instead of updating it from live audio. |
| Force WebGL2 | Restart the renderer on the WebGL2 fallback path for compatibility testing. This remounts the canvas. |
| Low-load Playback | Reduce render overhead during playback diagnostics so you can inspect behavior on slower systems or heavier songs. |
| Cavity Geometry | Choose which cavity geometry to request for diagnostics. Spherical requests still fall back to the rectangular basis today. |
| Inject Tone | Replace live audio with a synthetic test tone so you can inspect a known, repeatable input. |
| Tone Hz | Frequency of the injected test tone in Hz. Low values inspect renderable patterns; high values exercise bandwidth-limit diagnostics. |
| Tone Signal | Choose whether the injected test signal is a pure sine or an explicit harmonic series. |
| Tone Amp | Amplitude of the injected test tone — lower values produce subtler pattern excitation. |
| Log Frames | Write a debug snapshot to the browser console every N frames. Use 1 for every frame. |
Presets
The Presets folder lets you save and recall named snapshots of all current control values.
| Action | Description |
|---|
| Name field | Type a name for the preset you want to save. |
| Save | Save the current controls under the typed name. Overwrites any existing preset with the same name. |
| Load dropdown | Select a saved preset to restore its values. Modifying any control after loading clears the selection indicator. |
| Reset to defaults | Restore all controls to their factory defaults. |
| Delete Selected | Delete the preset currently shown in the Load dropdown (controls are left unchanged). |
localStorage as you adjust controls (debounced 500 ms), so your last session’s values are restored on next load. 
