Usage

Photograph a paper receipt

Open the app and tap [camera] Snap.
Take a photo of the receipt (or several photos for a long one — they're read in order).
The OCR runs on the server in the background; a spinner shows while it works, then the review screen opens automatically.

Behind the scenes: the photo is deskewed and contrast-boosted, a text-recognition model reads it into grounded text (with a confidence per line), and the LLM turns that text into line items. The source photos are saved (under the data volume) so a receipt can be re-read later.

Emailed receipts

With the IMAP variables set, the app watches your receipt folder. It runs automatically every SCAN_INTERVAL seconds, or hit Scan to check now. Supported senders include Shaw's, Stop & Shop (in-store and via DoorDash), and Amazon order emails; non-grocery items are skipped.

The review queue

Nothing reaches Grocy until you approve it. For each line you can:

Match it to an existing Grocy product (the search box suggests matches), or
New — create a Grocy product inline, with the full field set (group, location, unit, store, dates, min-stock...), or
Skip it, and
fix qty / price before stocking.

Other things to know:

Remember this mapping saves the receipt-name -> product mapping to an alias table, so the same cryptic line (MARS SNKR 3.29Z) maps silently next time. Reviews shrink over time.
Store is read from the receipt and matched to your Grocy shops — if you've created the store in Grocy, the dropdown pre-selects it (otherwise the name still fills in; use + New to add it).
An OCR? flag (gold) marks any line the OCR wasn't confident about — double-check its name/price.
Auto-skipped lines (coupons, deposits, prepared food, unreadable junk) sit in a collapsible Skipped section; if something was wrongly skipped, hit Stock it to bring it back.
Approve all writes stock to Grocy with the price and purchase date, and learns any "remember"-checked mappings.

Install it as an app (PWA)

In your browser, use Add to Home Screen / Install. You get an installable icon, and the Snap button can use the device camera directly — handy for snapping a receipt the moment you walk in the door.

On iOS behind an auth proxy, install from the browser you normally log in with; the app launches in that browser's session (see the Setup note on display: browser).

Tips

Create your usual stores in Grocy (Shaw's, Stop & Shop, Aldi, Amazon...) so the store dropdown auto-selects on each receipt.
For very long receipts, take multiple overlapping photos — they're OCR'd in order.
The first few photos teach the alias table; after that, most lines map themselves and you're mostly just clicking Approve all.