TROUBLESHOOTING

// every warning documented honestly, every fix spelled out

Windows: "Windows protected your PC"

The installer is Authenticode code-signed, but SmartScreen can still flag it while the certificate is new and building reputation — not because anything is wrong. Click More info → Run anyway.

macOS: "cannot be opened" / "is damaged"

Gatekeeper's standard message for un-notarized apps; the file is fine. After the first blocked attempt: System Settings → Privacy & Security → Open Anyway, or right-click the app → Open on older macOS. One-time only.

Linux: app won't launch

StarNet is a WebKitGTK app. If a library is missing:

sudo apt install libwebkit2gtk-4.1-0 libayatana-appindicator3-1 librsvg2-2

AppImage complaining about mounting usually means missing FUSE — install your distro's FUSE package.

Updates

The built-in updater (System → Updates) checks the public releases channel and verifies every update's signature against a key baked into the app before installing. This runs on all platforms and is independent of the OS-signing warnings above — even an "unsigned" install pulls only cryptographically verified updates.

Uninstalling

• Windows: Settings → Apps → Installed apps.
• macOS: quit StarNet, drag it from Applications to the Trash.
• Linux: sudo apt remove starnet, or just delete the AppImage.

Still stuck?

Open an issue on GitHub or email androo.agi@gmail.com. We'd rather hear about a broken thing than have you assume it's supposed to be that way.