Skip to content
Get CalGrid

Progress Monitoring

The Progress panel (bottom-right of each workspace) shows real-time statistics for the active dispatch job.


Progress Panel Elements

Percentage and Count

  • Large percentage number — overall completion (e.g., 72%)
  • X/Y counter — recipients processed / total recipients (e.g., 72/100)

Progress Bar

A 6px horizontal bar that fills from left to right as the job advances.

Stat Cards

Four counters below the progress bar:

Card Color Meaning
Total Neutral Total number of recipients in this campaign
Done Green Recipients who received a successful calendar event
Fail Red Recipients where the Google API returned an error
Left Neutral Recipients remaining to be processed

Status Badge

The small badge in the top-right corner of the Progress panel header shows the current state:

Badge Text Meaning
(empty) Idle
Working Job is running
Paused Job is paused
Done Job completed successfully
Stopped Job was stopped manually

Bottom Status Bar

The bottom status bar (across the full width of the window) also shows dispatch state:

Indicator Meaning
● Ready (grey) No active job
● Working (green) Dispatching
● Paused (amber) Job is paused
● Error (red) An error occurred

Understanding “Done” vs. Invitation Delivery

Done means Google Calendar API acknowledged the event creation request. It does not guarantee:

  • That the recipient opened or accepted the invitation
  • That the invitation email was delivered to the recipient’s inbox
  • That the event appears in the recipient’s calendar immediately

Google Calendar invitation delivery depends on Gmail delivery, the recipient’s calendar settings, and anti-spam filters — none of which CalGrid controls.


Fail Count and Retries

A Fail is counted when Google Calendar API returns an error for a recipient after all retry attempts are exhausted.

Common causes of fails:

  • Temporary Google API quota limits (HTTP 429)
  • Network timeouts
  • Invalid recipient email address rejected by Google Calendar

CalGrid automatically retries temporary errors using exponential backoff. The number of retry attempts is configured in Settings → Rate.


Logs

The live log view (accessible via ⚡ Debug in the bottom bar) shows detailed per-recipient results and API error details. See Debug Dialog for instructions.


Desktop Notifications

When a campaign finishes, CalGrid can show a Windows desktop notification. Enable or disable this in Settings → App.


Edit this page on Git