Tray status messages

The top line of the tray right-click menu shows GSCaddie's current state. The watcher (a background helper process) writes log lines that the tray translates into one of the messages below. Raw internal lines are suppressed; only the translated messages reach the menu.

Normal operational states

Authenticating... The initial status while the tray is starting. If it does not clear within a few seconds, the background helper may not have started yet.

Watching for shots Everything is working. The watcher is watching your sim PC and will pick up the next shot.

Authenticated Brief transient message shown when the watcher confirms it authenticated successfully against the backend.

ingest: inserted=N skipped=M... A shot was uploaded. The full ingest summary line appears here (truncated to 48 characters), for example "ingest: inserted=1 skipped=3 filtered=0 round=...". This tells you a new shot reached the database.

Round finished, will sync shortly GSPro signaled the end of the round. The tray has armed the after-round portal sync, which fires a short delay later so the round has time to reach the GSPro Portal.

GSPro relaunched, re-syncing This happens when you restart GSPro. The watcher reconnected and re-ran ingest.

Paused Shot capture is paused. Resume it from the tray menu.

Resumed Shown briefly after you click "Resume watching".

Shutting down The watcher is stopping. Normal when you click Quit.

Action-required states

Awaiting sign-in (open the dashboard to connect) GSCaddie does not have a valid auth file yet. Open the GSCaddie window and sign in. This is normal before the first sign-in on a new install.

Sign-in expired (click here to sign in again) The watcher exited with an authentication error. This item is clickable. Click it to re-authenticate through the GSCaddie window. A balloon notification also appears with the same message.

While the sign-in has expired the tray also shows this message transiently as the watcher logs the failure:

Sign-in expired. Right-click the GSCaddie tray icon and click the top status line to sign in again

Both messages mean the same thing and the fix is the same.

Reinstall needed (GSCaddie's background helper is missing) The watcher executable (gscaddie-watcher.exe) is not present in the install folder. The most common cause is antivirus quarantine. The item is not clickable. Reinstall from gscaddie.com. Adding a Windows Defender exclusion for %LOCALAPPDATA%\GSCaddieTray before reinstalling prevents the problem from recurring.

Transient error states

Couldn't sync the last shot, will retry on the next one An upload error occurred during ingest. The watcher is still running and will attempt to sync when the next shot arrives. If it keeps appearing, check your network connection or send a bug report.

GSCaddie's background helper hit an error, restarting (see Help / FAQ if it persists) The watcher logged a fatal error and the tray is restarting it. If this appears once and clears, no action is needed. If it recurs, open Help / FAQ and send a bug report.

GSCaddie's background helper stopped, restarting in 3s The watcher process exited unexpectedly (not from an auth error). The tray waits three seconds and restarts it automatically.