> ## 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.
# Settings
> A complete reference for all Voxcode settings and configuration options
The Settings panel gives you full control over Voxcode's appearance, voice visualization, navigation behavior, and more. To open it, tap the **gear icon** in the top navbar.
All settings are saved locally in your browser session. If you clear your browser data or switch to a different browser, your preferences will reset to their defaults.
***
## Opening settings
The gear icon sits in the top-right area of the top navbar, always visible regardless of which view you are in.
Tap the gear icon. The Settings panel slides in over a blurred backdrop.
The panel is scrollable. Each section is labeled — scroll down to find the setting you need.
Tap the **×** button in the top-right of the panel, or tap anywhere on the backdrop behind it.
***
## Settings reference
Controls the global look of the Voxcode interface.
**Theme**
Cycles through three color schemes. Tap the toggle to advance to the next theme.
| Value | Description |
| ------------------ | ----------------------------------------------------------- |
| **Default (Dark)** | Deep dark background with cyan accents. The default. |
| **Light** | Bright backgrounds and dark text for well-lit environments. |
| **Monokai** | Warm dark theme with a classic code-editor color palette. |
**UI Borders**
A toggle that shows or hides decorative borders around UI panels and cards. Off by default. Turn it on if you prefer more defined visual boundaries between sections.
**Chat Background**
Sets the background texture for the chat area. Three categories are available:
* **Solid** — Flat color fills: Default, Dim, or Warm.
* **Patterns** — Geometric textures: Dots, Grid, or Waves.
* **Cosmos** — Animated deep-space scenes: Cosmos (blue/purple), Cosmos Yellow (solar), or Cosmos Red (nebula).
See [Themes](/customization/themes) for a full description of each option.
Switches between the two voice visualization modes.
| Mode | Description |
| ----------- | -------------------------------------------------------------------------------------- |
| **3D Orb** | An animated 3D object rendered with WebGL that reacts to your voice in real time. |
| **Classic** | A flat 2D canvas-based waveform. Lower resource usage; five visual variants available. |
For a detailed walkthrough of all orb and waveform options, see [Voice Orb](/customization/voice-orb).
These settings are available when your Voice Display is set to **3D Orb**.
**Shape**
The 3D geometry used to render the orb. Changing the shape reinitializes the WebGL scene.
| Value | Geometry |
| -------- | ---------------------------------------------------------- |
| Sphere | Icosahedron with high vertex count for smooth deformation. |
| Cube | Box geometry with sharp, reflective edges. |
| Prism | Triangular cylinder. |
| Pentagon | Dodecahedron with 12 flat faceted faces. |
| Donut | Torus with a hollow center. |
**Style**
The shader applied to the orb surface.
| Value | Description |
| ------- | ----------------------------------------------------------- |
| Classic | Dark metallic surface with blue-purple emissive highlights. |
| Blue | Deeper blue tones with a cooler electric glow. |
**Mode**
Controls how much screen space the orb occupies during a voice session.
| Value | Description |
| ----- | ----------------------------------------------------------------------- |
| Half | Orb renders in the bottom half of the screen. Chat stays visible above. |
| Full | Orb fills the entire screen with a dark radial-gradient backdrop. |
**Vibration**
A slider from 1 to 5. Higher values make the orb react more dramatically to audio amplitude. Level 3 is the neutral baseline.
**Bottom Navbar** *(Full mode only)*
Toggle whether the bottom navigation bar remains visible over the full-screen orb. Default: on.
**Visual Feedback** *(Full mode only)*
Toggle whether the orb continues reacting visually during AI speech playback. Default: on.
These settings are available when your Voice Display is set to **Classic**.
**Wave variant**
Select the visual style of the 2D waveform drawn from your microphone input.
| Variant | Description |
| ------------ | -------------------------------------------------------------------------------------- |
| **Bars** | Five rounded vertical bars, each mapped to a different audio frequency band. |
| **String** | A continuous horizontal sine wave with amplitude driven by loudness. |
| **Circle** | A single circle that expands in radius based on mic input. |
| **Dots** | Five dots that grow in size based on their respective frequency band. |
| **Spectrum** | Eight bars spanning the full width, mapped to frequency bins like a spectrum analyzer. |
Controls how you navigate between panels and sidebars.
**Swipe Gestures**
Enables horizontal swipe gestures to open and close the sidebars.
* Swipe **left** to open the File Explorer (right sidebar), or close the History sidebar if it is open.
* Swipe **right** to open the History sidebar (left sidebar), or close the File Explorer if it is open.
A minimum swipe distance of 50px is required to trigger navigation. Disable this if you find swipes interfering with text selection or scrolling.
**Side Toggles**
Shows or hides the sidebar toggle tab buttons on the left and right edges of the screen. Hidden by default. Enable them if you prefer visible tap targets over swipe gestures.
**Sidebar Buttons**
A master switch that enables or disables the action buttons inside the History and File Explorer sidebars. When disabled, the sidebars still open but the buttons within them are inactive.