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

# Voice Orb

> Customize the animated Voice Orb that visualizes your speech in Voxcode

The Voice Orb is Voxcode's primary voice visualization. It's a real-time animated 3D object rendered with WebGL that reacts to your microphone input — scaling, rotating, and shifting color as you speak. When the AI responds, it can pulse in sync with the audio playback, giving you a continuous visual signal of the conversation state.

You can fully customize how the orb looks and behaves, or switch to a flat 2D waveform if you prefer a lighter visual style.

## Accessing voice display settings

All Voice Orb and waveform options are in the **Voice & Audio** section of Settings.

<Steps>
  <Step title="Open Settings">
    Tap the gear icon in the top-right corner of the app.
  </Step>

  <Step title="Scroll to Voice & Audio">
    Find the **Voice & Audio** section. The **Display Style** selector is at the top.
  </Step>

  <Step title="Choose a display mode">
    Select **3D Orb** to use the Voice Orb, or **Classic** to use the flat 2D waveform. The options below the selector update to match your choice.
  </Step>
</Steps>

***

## Orb options

When you select **3D Orb** as your display mode, the following settings become available.

### Shape

Choose the 3D geometry the orb renders as. The shape is re-initialized each time you change this setting.

<AccordionGroup>
  <Accordion title="Sphere" icon="circle" defaultOpen={true}>
    A smooth icosahedron mesh — the default shape. The high vertex count lets the audio-driven displacement shader produce fluid, organic ripples across the surface.
  </Accordion>

  <Accordion title="Cube" icon="cube">
    A box geometry. The metallic material and bloom post-processing give the cube sharp, reflective edges that deform subtly with your voice.
  </Accordion>

  <Accordion title="Prism" icon="shapes">
    A triangular cylinder. The three-sided silhouette creates a distinctive prism form that rotates and pulses with audio input.
  </Accordion>

  <Accordion title="Pentagon" icon="pentagon">
    A dodecahedron (12-sided polyhedron). The flat faces create a faceted, gem-like appearance that catches the room-environment lighting.
  </Accordion>

  <Accordion title="Donut" icon="ring">
    A torus geometry with a thick circular cross-section. The hollow center produces a completely different silhouette and makes the audio reactions more visible from all angles.
  </Accordion>
</AccordionGroup>

### Style

Controls the shader applied to the orb surface.

| Style       | Description                                                                                             |
| ----------- | ------------------------------------------------------------------------------------------------------- |
| **Classic** | A dark metallic surface with blue-purple emissive highlights that glow when audio activity is detected. |
| **Blue**    | An alternate shader with deeper blue tones and a cooler, more electric glow.                            |

### Mode

Controls how much of the screen the orb occupies when you are in a voice session.

| Mode     | Description                                                                                 |
| -------- | ------------------------------------------------------------------------------------------- |
| **Half** | The orb renders in the bottom half of the screen. The chat area remains visible above.      |
| **Full** | The orb fills the entire screen with a dark radial-gradient backdrop, hiding the chat view. |

### Vibration intensity

A slider from **1 to 5** that scales how dramatically the orb reacts to audio. At level 1, displacement is minimal. At level 5, the orb expands and distorts more aggressively in response to loud or energetic speech.

Level 3 is the neutral baseline. Levels below 3 produce subtler reactions; levels above 3 produce more exaggerated movement.

### Orb feedback

Available only in **Full** mode. When enabled, the orb continues reacting visually during AI speech playback, not just while you speak. Disable this if you want the orb to stay static while the AI responds.

### Bottom navbar

Available only in **Full** mode. When enabled, the bottom navigation bar remains visible over the full-screen orb. Disable it for a fully immersive, distraction-free view.

<Tip>
  For the most vivid experience, start with the **Sphere** shape, **Blue** style, and vibration set to **4** or **5**. The blue shader combined with the smooth sphere geometry produces the most fluid audio reaction, especially on high-frequency speech.
</Tip>

***

## Classic waveform

If you select **Classic** as your display mode, the orb is replaced by a 2D canvas-based waveform drawn in real time from your microphone input.

### Waveform variants

| Variant      | Description                                                                                                                              |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Bars**     | Five rounded vertical bars that scale in height based on audio frequency bands. The central bar reacts most strongly to mid frequencies. |
| **String**   | A horizontal sine wave that oscillates in amplitude based on audio loudness. The wave animates continuously even when the mic is silent. |
| **Circle**   | A single circle that expands outward based on mic input. Louder audio produces a larger radius with a faint fill.                        |
| **Dots**     | Five dots arranged horizontally that grow in size based on their respective frequency band.                                              |
| **Spectrum** | Eight vertical bars spanning the full width, each mapped to a different frequency bin. Similar to a traditional audio spectrum analyzer. |