Skip to content

Features

mxkissnr edited this page Jun 19, 2026 · 4 revisions

Language: English | Deutsch

Features

Shot Archive

All shots synced from the Gaggiuino controller, displayed in a sidebar with pressure, flow, weight and temperature curves. Each shot shows profile name, timestamp, bean, grinder and a colored score pill.

Live Mode

Real-time display polling the controller directly via /api/system/status every second. Brew-start detection is immediate — no delay from the HA polling interval. Timer ticks smoothly every 100ms.

Auto-Sync

New shots load automatically when sensor.gaggiuino_latest_shot_id rises (requires the Gaggiuino HA integration). Manual sync also available.

Compare Mode

Overlay two shots side by side in the chart. Click to enter compare mode, then select Shot B from the sidebar.

Annotations & Rating

Per-shot notes: coffee/bean, grinder, grind setting, dose (g), roast date, TDS %, free text. 1–5 star rating. All data persists in /data/annotations.json.

Coffee Library

Persistent bean and grinder database. Saved beans appear as autocomplete suggestions in annotation fields. Roast date auto-fills when a matching bean is selected. See Coffee Library.

Shot Score

Automatic 0–100 score based on extraction pressure, temperature stability, duration, dose-to-yield ratio and channeling. Shown as a colored pill in the sidebar and top-right of the shot view. See Shot Score.

Analytics

Dedicated tab with score trend chart, shot calendar heatmap, bean stats and profile performance. See Analytics.

Sidebar Sorting

Sort shots by: Newest / Score / Rating / Duration. Click the active button again to reverse order (↑/↓).

Analysis Metrics

  • Dose → Yield → Ratio (e.g. 18 g → 36 g · 1:2.0)
  • Extraction Yield % (EY) — calculated from TDS and dose
  • Temperature stability (±σ)
  • Phase detection: Preinfusion and Extraction with timestamps
  • Channeling warning (sudden pressure drop > 1.5 bar)

P·Q Diagram

Alternate chart tab showing pressure (Y) vs. pump flow (X). Reveals extraction signature of the puck — tight curve = even extraction, wide curve = channeling.

Grind Recommendation

Automatic advice based on shot duration and channeling detection.

Duration Recommendation
< 18 s Grind finer
18–22 s Grind slightly finer
23–42 s Grind setting is good
43–50 s Grind slightly coarser
> 50 s Grind coarser
Channeling detected Check puck prep (distribution & tamping)

Roast Date & Freshness

Days since roast shown as a colored badge next to the bean name. Green = 7–21 days (optimal window).

Shot Search

Filter the sidebar by profile name, coffee/bean or grinder — live as you type.

Fullscreen Chart

button expands the chart to fullscreen overlay. Auto-rotates to landscape on mobile.

Multi-Language UI

DE / EN / IT / FR / ES / NL selectable via dropdown in the sidebar footer. Auto-detected from browser, persisted in localStorage across sessions and add-on updates.

Smart Plug

Optional: power the machine on/off via a HA switch entity. Live tab is automatically disabled when the machine is off. See Configuration.

Preheat Timer

After the machine switches on, a progress bar + countdown shows the configured warm-up time; a "ready to brew" badge appears when done. Smart reset ignores brief off/on cycles while still warm. When a barista notify device is set, a localized "machine ready" notification is sent once per warm-up cycle.

Maintenance Tracker

Track machine maintenance — descaling, backflush, group head, gaskets, water filter — and per-grinder cleaning, each with a configurable shot/day threshold and status (ok / soon / due / never). A maintenance log records each completion. Status is also exposed as HA sensors and can be marked done from the GLP Lovelace card.

Order Management

Barista backend to take espresso orders: a configurable menu (emoji + drink, variants, bean-sourced variants, "new"/"trending" badges), a queue with accept-and-ETA / complete / decline, per-customer push notifications and milk-stock deduction. Customers order via the companion GLP Order Card; the barista can also manage the queue from the GLP Lovelace card.

Dial-in Assistant

Compares a target shot with recent attempts of the same coffee + grinder + profile and suggests whether to grind finer/coarser based on which grind setting historically scored best.

Barcode / QR Scanner

Scan coffee-bag barcodes (EAN/UPC) via the camera — name and roaster are looked up on Open Food Facts. Each bean card generates a shareable GLP QR code for full bean import between installations.

kaffeebraun.com Import

Paste a product URL from kaffeebraun.com — name, roaster, aromas, origin, roast level and processing are imported automatically.

Themes

Five accent color schemes (Amber, Ocean, Aurora, Ember, Forest) plus a light/dark theme toggle; both persisted in localStorage. A matching glp-ha-theme.yaml themes the wider HA interface.

Exports

  • .shot export — Decent Espresso format, compatible with Visualizer.coffee
  • CSV export — current shot with all annotation fields

Delete / Trash

Trash button (🗑) in the sidebar moves shots to a collapsible Papierkorb section. Trashed shots are auto-deleted after 30 days. Restore (↩) or permanently delete (✕) any time. Deleted shots are added to a blocklist so they are never re-synced from the machine.

Data Persistence

Shots and annotations survive add-on updates and container restarts — all data lives in /data/ (HA persistent storage).

Clone this wiki locally