Troubleshooting

The things that actually go wrong, and what to do about them.

It will not install or start

“Some files are missing”

The ZIP was only half extracted. Extract it again, keeping every file together, and open the launcher from the extracted folder — not from inside the ZIP.

Nothing happens when I double-click the launcher

Windows blocks files downloaded from the internet. Right-click the launcher → Properties → tick Unblock → OK.

Setup failed part-way

Almost always no internet, or antivirus holding a file while it is being written. Open the launcher and choose Set up again (repair).

The port is already in use

Another program has it. The launcher picks a free port automatically; if you set one by hand, choose a different one.

Numbers look wrong or missing

No rankings at all

Check Search Console is connected for that client. Without it, rankings come from a live search, which search engines sometimes block — the tool reports that as a blocked check rather than as “not ranking”, so look for that message.

Nothing has updated for days

Scheduled work only runs while the app is running. See Automation.

An AI feature says it needs a provider

No AI key is connected. Settings → Connect accounts. Gemini and Groq are free.

Getting help

The control panel has Collect info for support, which gathers diagnostics you can paste into an issue. Open one at GitHub — include what you expected, what happened, and that diagnostic output.