Troubleshooting
Common problems and how to fix them.
The app opens to a black window and stays stuck
Your antivirus is probably blocking the app's scripts as it starts. With Malwarebytes, open Malware and PUP protection and turn Advanced script and fileless protection off, then start the app again. Other antivirus products have similar script or behaviour protection: add the 360 Gaussian Pro install folder as an exclusion instead of turning protection off.
The app fails at the align step right away
Usually a GPU driver issue. Alignment needs a GPU with Vulkan 1.1, which any recent NVIDIA, AMD or Intel driver provides. On NVIDIA, the fast CUDA path also needs driver R580 or newer. Update to the latest driver from your GPU maker's website, restart the computer and try again.
If the app finds a GPU or driver problem at startup, it opens a GPU / driver problem window that says what to update.
Masking is very slow
Check the startup lines of the log. If masking found no usable GPU it runs on the CPU, at roughly 10 seconds per frame. Update the GPU driver — masking needs a DirectX 12 GPU. On NVIDIA, a driver older than R580 makes masking fall back to DirectML, which is about 3× slower.
Masking ran out of memory
Very long clips or large batches (thousands of frames) can run out of memory. The step then stops with Out of memory while masking. Extract fewer frames (lower the frame rate) and run Run Mask again. Masks already made are kept, so the run continues where it stopped.
Brush ran out of GPU memory
Lower Max Splats in the Train tab — the log suggests a value — and train again.
Interior scan won't align all the rooms
Multi-room interiors are the hardest case for alignment: each room has its own lighting, doorways give the matcher very little overlap to work with, and repeating layouts or décor can fold two rooms into one.
Try these in order:
- Turn off the Global mapper (GLOMAP). On the Alignment tab, switch GLOMAP off so the app falls back to the incremental mapper. It registers rooms one frame at a time instead of solving everything at once, which is much more robust across doorways — slower, but it usually picks up the rooms GLOMAP drops. See Global mapper.
- Shoot the doorways. Rooms only link where the footage overlaps. Walk slowly through each doorway and pause so consecutive rooms share plenty of frames — a quick step through a door rarely gives the matcher enough to connect on.
Ask AI about an error
The Log view has an Ask AI button. Its border blinks when an error appears in the log.
- Click Ask AI in the Log view toolbar. Nothing is sent yet — the AI troubleshooter panel opens.
- Click Show what is sent if you want to check the log excerpt first.
- Click Ask AI in the panel. After up to a minute you get a verdict — You can fix this, Looks like a bug in the app or Not sure yet — with steps to try.
- If it looks like a bug, or the answer didn't help, add an optional note and email under Send to developer and click Send report. The log and the AI's answer go to the developer.
Only the error part of the log is sent, with your Windows user name, folder paths and email addresses removed first. Your footage never leaves your computer. What is sent, and to whom, is described in the privacy policy.
Still stuck? Note which step failed and what the log said — that's the fastest way to a diagnosis. Then ask on our Discord and we'll help you figure it out.