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

# FAQ & Troubleshooting

> Common questions and solutions

## Display Issues

<AccordionGroup>
  <Accordion title="The screen is black after loading">
    * Ensure your browser supports **WebGL2** (Chrome or Edge recommended).
    * Enable hardware acceleration: Chrome → Settings → System → "Use hardware acceleration".
    * Update your GPU drivers.
  </Accordion>

  <Accordion title="Performance is slow">
    * Use **Google Chrome** for best performance.
    * Close other browser tabs to free memory.
    * Ensure GPU acceleration is enabled.
    * Check that you have at least 8 GB RAM.
  </Accordion>
</AccordionGroup>

## Segmentation

<AccordionGroup>
  <Accordion title="Meshes don't appear after segmentation">
    * Verify Spine Helper is connected (check status in right panel).
    * Ensure segmentation completed successfully (no error message).
    * Try toggling mesh visibility with the eye icon.
  </Accordion>

  <Accordion title="Helper connection failed">
    * Ensure Spine Helper is running.
    * Check that port **18765** is not blocked by a firewall.
    * Restart the Helper application.
    * On macOS, check System Settings → Privacy & Security for any blocks.
  </Accordion>

  <Accordion title="Cannot run segmentation while recording">
    Segmentation and screen recording are mutually exclusive. Stop the recording first, then run segmentation.
  </Accordion>
</AccordionGroup>

## Tools

<AccordionGroup>
  <Accordion title="W/L tool turned off my Pointer">
    This is expected behavior. **Pointer**, **W/L**, and **Ruler** are mutually exclusive — activating one deactivates the others.
  </Accordion>

  <Accordion title="Endoscope button is disabled">
    The Endoscope requires completed segmentation meshes. Run segmentation first, then try again.
  </Accordion>

  <Accordion title="3D Cut and Transparency toggles are grayed out">
    These controls are disabled when meshes are hidden. Toggle mesh visibility on (eye icon) first.
  </Accordion>

  <Accordion title="Adaptive clip mode is disabled">
    Adaptive mode requires an axial image profile. If your scan doesn't include axial data, only Manual mode is available.
  </Accordion>
</AccordionGroup>

## Export

<AccordionGroup>
  <Accordion title="MP4 format is not available">
    MP4 export requires the **WebCodecs API**, available in Chrome 94+ and Edge 94+. Use WebP as an alternative in other browsers.
  </Accordion>

  <Accordion title="Recorded video won't play">
    * Try opening with **VLC** media player (supports both MP4 and WebM).
    * If the file is WebM, some players may not support it natively.
  </Accordion>
</AccordionGroup>