Docs

Implement the Logger

The logger is a C++ library for Qt applications. Add it to your application from the repository, then configure InteractionLogger for recording. For network delivery, use HttpUploader with HttpUploaderOptions.

Supported events

The logger can record button clicks, slider changes, detected gestures, toggle changes, text edits, combo-box changes, and spin-box changes. Give widgets stable Qt objectName values so activity is recognizable.

Database export

Logger databases contain metadata, interactions, and sessions. Timestamps use UTC microseconds. The dashboard ignores event IDs it has already imported, preventing duplicate activity.

Upload over HTTP

The HTTP uploader sends JSON with an interactions array. A receiving endpoint should persist each event_id idempotently and return a 2xx response only after accepting the batch. Failed batches are retained by the logger.

POST /your-ingestion-endpoint
Content-Type: application/json

{ "interactions": [
  { "event_id": "…", "event_type": "button_clicked", "element_name": "save_button" }
] }

Direct logger ingestion is not part of this dashboard MVP. Use SQLite import until your deployment provides an endpoint.

Log intentionally

UI names, event values, optional serial numbers, and session data may become personal data depending on configuration. Avoid sensitive text fields and collect only the values you need.

Logger licensing

GooeyFlow Logger is available under the MIT License. Copyright © 2026 Kee-3PO. The license permits use, copying, modification, and distribution subject to its copyright-and-permission-notice requirement.