> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baryon.live/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Control panel reference

> Reference for the Baryon GUI controls and diagnostic settings.

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](/public/guides/first-session). For the conceptual model behind these settings, see [Understanding the engine](/public/guides/understanding-the-engine). Desktop OSC, OSCQuery, and MIDI control-input setup lives in [Parameter Automation](/public/desktop/parameter-automation); outbound modal-structure data lives in [OSC Structure Export](/public/desktop/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. |

<Note>
  Baryon does not currently expose keyboard shortcuts for manual cymatic
  rotation. The only currently documented keyboard shortcut is fullscreen where
  the host exposes it.
</Note>

***

## Audio Input Profiles

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. |

The mic path auto-calibrates when the microphone starts and whenever you switch profiles.

***

## 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.                                                           |

***

## Performance

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).                            |

Settings are also auto-saved to `localStorage` as you adjust controls (debounced 500 ms), so your last session's values are restored on next load.
