Skip to content

Usage

Jump to bottom
mxkissnr edited this page May 23, 2026 · 2 revisions

Language: English | Deutsch

Usage

Shot Archive

  1. Start the add-on and open the dashboard via Open Web UI
  2. Shots appear in the sidebar after the first sync
  3. Click a shot → profile view with chart and all measurements
  4. ⇄ button → compare mode (select Shot B from the sidebar)
  5. Annotation panel below the chart → enter data and click Save
  6. ⤢ button → fullscreen chart (auto-rotates to landscape on mobile)
  7. ‹ button → collapse sidebar for more chart space (desktop)

Live Mode

  1. Click the Live tab at the top of the dashboard
  2. Once the brew switch is active, the real-time display starts automatically
  3. Stat boxes and chart update every second directly from the controller
  4. The shot timer ticks smoothly every 100ms (client-side, re-synced with machine data each poll)
  5. After the shot ends, the complete shot is synced automatically

The live mode polls /api/system/status on the Gaggiuino controller directly — not via HA sensors. Brew-start detection is immediate.

Live mode data sources

Field Source Endpoint
Brew switch (start/stop) Gaggiuino direct /api/system/status → brewSwitchState
Pressure Gaggiuino direct /api/system/status → pressure
Temperature Gaggiuino direct /api/system/status → temperature
Weight / flow Gaggiuino direct /api/system/status → weight
Target temperature Gaggiuino direct /api/system/status → targetTemperature
Auto-sync (new shot) HA sensor (optional) sensor.gaggiuino_latest_shot_id

Compare Mode

  1. Select Shot A from the sidebar (shown in the main chart)
  2. Click the ⇄ button in the toolbar
  3. Click Shot B in the sidebar — both shots overlay in the chart
  4. Datasets are labeled (A) and (B) in compare mode

Annotations

Enter per-shot data in the panel below the chart:

Field Notes
Coffee / Bean Autocomplete from Coffee Library
Grinder Autocomplete from Coffee Library
Grind setting Free text
Dose (g) Required for Ratio and EY calculation
Roast date Auto-fills from Coffee Library; used for freshness badge
TDS % Required for EY calculation
Notes Free text
Rating 1–5 stars

Click Save to persist. Annotations are stored separately from shot data and survive sync operations.

Extraction Yield (EY)

EY = (Beverage Weight × TDS %) / Dose

Enter dose and TDS % (measured with a refractometer) to have EY calculated automatically.

Color Range Meaning
Green 18–22 % Optimal extraction
Yellow 16–17 % or 23–24 % Slight under/over-extraction
Red < 16 % or > 24 % Significant under/over-extraction

Deleting Shots

The trash button (🗑) in the sidebar moves a shot to the Papierkorb (trash) section. Trashed shots are auto-deleted after 30 days. You can restore (↩) or permanently delete (✕) at any time.

The sync is incremental and one-directional — it only fetches shots with an ID higher than the current local maximum. Deleted shots are added to a blocklist so they are never re-downloaded.

What you delete Result
An older shot (not the latest) Safe — stays deleted
The most recent shot (highest ID) Will come back on the next sync

Clone this wiki locally