Troubleshooting

• "No WebGL2 context" — the app checks for a working WebGL2 context at startup and shows this screen instead of a blank window when getContext('webgl2') returns null. Update your GPU drivers, or check chrome://gpu for what was blocklisted.
• A black or empty 3D view with a mesh loaded — the mesh may have no surface triangles of its own (SimNIBS grey_*.msh files have none). Tetravox extracts the boundary for you; if it is still empty, check the tissue table for everything switched off.
• "Reduced precision" in the status bar — your GPU lacks EXT_texture_norm16, so a 16-bit volume is being displayed through an 8-bit texture. Values you probe are unaffected: they are read from the original samples, not from the texture.
• A slow, software renderer — the status bar names the renderer. chrome://gpu in any Chromium says why the GPU was refused.
• The window opens black on a light theme — please report it; the background colour is meant to be read from your saved theme before the first frame.
• A large mesh is slow to load or the app feels sluggish — a head mesh can be well over 100 MB; loading and re-loading it (for example via "reopen last scene on launch") costs real time and memory. Keep that setting off unless you want it, and prefer opening one heavy dataset at a time when memory is tight.
• macOS refuses to open the app ("Tetravox is damaged and can't be opened") — the official releases are signed and notarised and open directly; this is Gatekeeper's message for an unsigned local build (pnpm package without a certificate), not a corrupted download. xattr -dr com.apple.quarantine /Applications/Tetravox.app clears it once. Clear the quarantine attribute: xattr -dr com.apple.quarantine /Applications/Tetravox.app.
• A scene won't fully load — "Locate" dialog appears — Tetravox couldn't find one or more files at any of the three places it checks (path relative to the scene, the absolute path it had when saved, or the file's own name next to the scene file). Point Locate at the real file, or Skip it to open the rest of the scene without it.