Troubleshooting¶

The viewer won't start¶

Linux: "CPU ISA level is lower than required" or a glibc error. You need glibc 2.38+ and an x86-64-v2 CPU; see Installing.
No Vulkan device. Update your GPU driver. On Linux make sure the Vulkan driver package for your GPU is installed (vulkan-radeon / nvidia-utils etc.); vulkaninfo --summary should list your GPU.
Windows: SmartScreen blocks the installer. The build is unsigned; choose More info → Run anyway.
GPU "device lost" / the viewer closes suddenly. Update your graphics driver first. If it keeps happening, send a crash report.

Logging in takes a long time¶

After the progress bar fills it can take 30–60 seconds to reach the world. This is a known issue being investigated; it isn't a sign that anything is broken.

Low frame rate¶

See Graphics & performance. The usual culprits are projector shadows in busy scenes, then shadow quality. If it's still slow, send a log with RenderVKGpuTimers turned on.

Shadows look blocky or jagged¶

Raise Shadow quality (Graphics → Advanced) or set Filtering to High or Ultra in Photo Studio → Scene → Shadows. With ray-traced shadows, adjust Shadow softness instead.

Textures look wrong or won't finish loading¶

Right-click the object or avatar and use Refresh Textures to download its textures again. If lots of textures everywhere stay blurry, your graphics card's memory is probably full: see Video memory.

An avatar is stuck in a T-pose or frozen¶

Right-click the avatar → Appearance → Refresh Animations. See Fixing stuck avatars.

Audio sounds muffled or "like bad headphones"¶

That's 3D binaural (HRTF) processing. It is off by default; if you turned on AudioOpenALHRTF, turn it off again.

An avatar stays blurry¶

The viewer logs extra detail automatically when an avatar stays blurry for a minute. Include your Slipstream.log in a bug report.

The UI is the wrong size¶

Adjust Preferences → Advanced → UI size. On Linux, native Wayland gives the sharpest result; forcing X11 in a scaled Wayland session can make everything blurry.