Skip to content

Getting Started

Jump to bottom
cubicj edited this page Aug 10, 2026 · 5 revisions

English · 한국어

Getting Started

Open the brewing view

Click the coffee icon in the ribbon, or run the command Open Brewing View. The brewing panel opens in the right sidebar.

Connect your scale

  1. Turn on the Acaia Pearl S and make sure no other app is connected to it (close the Acaia app on your phone — the scale accepts one connection at a time)
  2. Click Connect Scale at the top of the brewing view
  3. The plugin scans, connects, and shows Connected with the live weight readout

If the connection drops mid-session, the plugin retries automatically (up to 3 attempts). You can also use the Connect / Disconnect Scale command.

The brew flow

The brewing view walks you through five accordion steps:

  1. Brew Method — Filter or Espresso; each has its own parameter set
  2. Bean Selection — pick from your active beans; the previous brew's settings are shown for reference
  3. Brew Variables — grinder, grind size, RPM, dose, water temperature, and dripper/filter (Filter) or basket/drink (Espresso). Dose can be auto-filled from the scale
  4. Brewing — press Start Brewing; the live weight chart records your pour. For espresso, press Done when the shot finishes
  5. Memo — add notes and save. The bean's remaining weight is reduced by the dose automatically

Commands

Command What it does
Open Brewing View Opens the sidebar panel
Connect / Disconnect Scale Toggles the BLE connection
Tare Scale Zeroes the scale
Auto-fill Weight Fills the dose field from the current scale reading
Proceed / Start / Stop / Save Advances the brew flow — handy on a hotkey so you never touch the mouse mid-pour
Power Off Scale Turns the scale off

Record keeping with code blocks

Three code blocks render live widgets in your notes:

  • ```beans — bean inventory hub. Add it to any note (e.g. a "Coffee Dashboard"); one per vault is enough. Shows active/finished beans, roast days, remaining weight, and a + New Bean button
  • ```brews — per-bean brew history table. Auto-inserted into new bean notes; requires type: bean frontmatter
  • ```brew-day — daily brew records. Add it to a daily note named YYYY-MM-DD.md
Bean inventory with roast days and remaining weight

Bean inventory — roast days, remaining weight, and status tracking per bean

Brew records table with date, method, and memo

Per-bean brew history table

Brew detail modal with profile chart

Brew detail — extraction parameters and weight-over-time profile chart

Bean notes are regular notes with frontmatter — no special folder structure required:

---
type: bean
roaster: My Roaster
status: active
roast_date: 2026-03-01
weight: 200
---

Settings

  • Bean Folder — where new bean notes are created
  • Language — English or Korean (restart Obsidian to apply)
  • Debug Log — writes a plugin log file, useful for bug reports (see Troubleshooting)

Where your data lives

Everything is stored as plain files inside your vault, so Obsidian Sync and backups just work:

Data Location
Bean notes Your Bean Folder (regular markdown notes)
Brew records cubicj-brewing/brew-records.json
Brew profiles (weight curves) cubicj-brewing/brew-profiles/*.json
Equipment & plugin settings .obsidian/plugins/cubicj-brewing/data.json

English

한국어

Clone this wiki locally