Capri Desktop troubleshooting

The fixes below come from the project’s release notes and its GitHub issues: 126 issues and pull requests were open on November 8, 2026, and of the 78 most recent issues read for this page, 17 are labelled bugs. Each problem links to its issue so you can see whether it has been fixed since.

First: copy her error details

Right-click Capri › Help › Copy error details copies errors.txt, which holds crashes, lag reports (any freeze of 2 seconds or more) and Windows’ own error text, with keys hidden. Since 0.8.4 she also says in plain words what went wrong: a key with no credit, Gemini’s used-up day, a mic problem, or an antivirus that took llama-server.exe or tts-server.exe.

Antivirus flags or deletes the installer

• Reports: Defender as Trojan:Win32/Wacatac.B!ml, .C!ml or .H!ml (#146, #183, #194); 9/68 VirusTotal engines on 0.8.4 (#148) and 23/71 on 0.8.5 (#194); Chrome blocking the download (#148).
• What the project says (#201): the .NET runtime compiles code in memory and sets up exception handlers, which sandboxes read as unbacked memory or unhooking; Capri has no code that does those things. Start with Windows looks like persistence, so new installs will start with it off (#199).
• What you can do: confirm the SHA-256 with the checker, read SECURITY.md in the repository, and decide. Don’t turn off your antivirus for it. If an antivirus later removes llama-server.exe or tts-server.exe, her local brain or voice stops and she tells you so.

SmartScreen or macOS blocks her

Windows: “Windows protected your PC” appears because she is not code-signed. More info → Run anyway, after the checksum matched. macOS: “damaged” or “can’t be opened” means the quarantine flag: xattr -dr com.apple.quarantine /Applications/Capri.app.

Her brain doesn’t answer

• After a PC restart she may not find her brain until you press Refresh a few times (#160).
• “Waiting for NVIDIA” for a long time is her slow-brain hint: a long reply on the free key (#166).
• A free Gemini key runs out for the day; she says so. Switch to the NVIDIA key or wait.
• Running a game as administrator can keep her out of it; since 0.8.5 she tells you to run her as administrator too.

Microphone, voice and calls

• Her voice cuts off about once or twice in 50 replies (#158, 0.8.4). Updating is the first step.
• She says one line on Discord and stops: turn off Discord’s Echo Cancellation and Noise Suppression.
• She goes quiet in call mode after a while (#171); reopen call mode.
• VB-CABLE errors when setting up her voice in your mic (#169): the error may come from VB-Audio’s own setup; copy the exact message.
• Ears won’t download: fixed in 0.8.5.1. For another language, pick it under Mainframe › Settings › YOU › Language and she fetches the 487 MB pack.
• “Hey Capri” does nothing: it is off by default (Settings › HABITS › Security) and works on Windows in English only.

Updates fail

• Right-click › Check for updates, or download the newest Capri-Setup.exe and run it over the old one; settings and memories stay.
• If a copy started as administrator is running, the installer now asks Windows to close it instead of failing with “access denied” (0.8.5).
• Installed through winget, Scoop, Chocolatey or pacman? Update through that tool.
• Mac and Linux do not install updates by themselves yet: replace the app with the new download.

She floats, vanishes or sits on nothing

• Floats above the taskbar after you come back (#156): drag her a few pixels and she sits back down.
• Teleports into the air with her sitting animation (#155): her next move or leaving full screen usually drops her onto the taskbar.
• Invisible in a DirectX 11 game, like Ghostrunner 2, while her comments still play (#159): launch the game in DirectX 12 if it offers it.
• Stuck to your cursor: Ctrl + Alt + C gets her off. Ctrl + Alt + H hides or shows her.
• Staying on top: she stays above games by design; Quiet (Ctrl + Alt + P) stops comments and pop-ins until you press it again.

Timers, music and clips

• Timers 15 to 30 minutes late during a game (#168): over full-screen apps reminders only show in her bubble, so they are easy to miss.
• A second “play” fails with “Spotify won’t let me” (#167): ask again, or start the song yourself.
• Clips look poor, stay at 30 fps or click (#157); and only “clip that” works, not longer phrasings.

Mac and Linux problems

• Mac: the Mainframe stays open after Quit following the Screen Recording prompt (#154); only a restart cleared it in the report.
• Linux on Wayland: she sits on the bottom of the screen; on niri she has been reported stuck in the middle (#149).
• Linux: she slides around by herself (#170, 0.8.3); 0.8.4 changed how she lands, so update first.
• Chromebook (ChromeOS Linux): the AppImage crashes at start with an X11 InvalidCastException (#213).

Still stuck?

Search the GitHub issues for your problem, then post your copied error details with what you did and what happened. The project also runs a help page at capriai.app/help/ and a Discord linked from its README.