Startup & Logging

The startup overlay shows loading progress, and the built-in log viewer helps diagnose issues.

A progress overlay with an animated aperture spinner appears while Blue Synergy loads. A log viewer in Settings lets you see what the app is doing and export diagnostics.

Startup overlay

The loading overlay appears automatically on every launch. It shows:

  • An animated aperture spinner
  • The current loading step (Config, Database, Clipboard listener…)
  • A progress bar

It dismisses itself once startup is complete. No action needed.

Log viewer

View app diagnostics under Settings → Maintenance → Logging:

  1. Capture level — controls what gets recorded: Error, Warn, Info (default), Debug, Trace. Set to Debug or Trace for troubleshooting.
  2. Log to file — write logs to disk (off by default).
  3. Log Viewer table — color-coded entries with timestamp, level, and message.
  4. Use the Show dropdown to filter by severity.
  5. Refresh — load latest entries. Clear — wipe the buffer.

Finding startup timing

Set capture level to Debug, restart, then look for [startup] entries — they show how long each of the 12 startup steps took.

Tips & gotchas

  • The ring buffer holds 2,000 entries. At Trace level, older entries drop off faster.
  • Log to file is off by default to avoid unnecessary disk writes.
  • Changing the capture level takes effect immediately for new messages.

Configuration

Setting Default Description
Capture level Info Minimum severity to record
Log to file Off Write logs to a file in addition to the viewer
Max file size 5 MB Max per log file (when file logging is on)

Find these under Settings → Maintenance → Logging.