ReceiptScanner

ReceiptScanner is a Grocy addon dedicated to receipt OCR on /purchase.

It handles:

• image and PDF receipt import
• OCR parsing of product lines, quantities, and prices
• Grocy product matching with confidence scoring
• review in a pop-up before import
• batch purchase import into Grocy
• server-side remembered matches for recurring receipt labels

Dependency

NerdCore is required.

Runtime files

• Payload: config/data/custom_js_receipt_scanner.html
• State: config/data/receiptscanner-addon-state.json
• Active composed file: config/data/custom_js.html

Page

• Main UI: /purchase

Install

Windows:

cd addon\scripts
.\install.ps1 -GrocyConfigPath "C:\path\to\grocy\config"

Linux/macOS:

cd addon/scripts
./install.sh /path/to/grocy/config

Update

Windows:

cd addon\scripts
.\update-from-github.ps1 -GrocyConfigPath "C:\path\to\grocy\config"

Linux/macOS:

cd addon/scripts
./update-from-github.sh --config /path/to/grocy/config

Release assets

• Stable tag: vX.Y.Z
• Prerelease tag: vX.Y.Z-alpha.N / vX.Y.Z-beta.N
• ZIP asset: receiptscanner-addon-vX.Y.Z.zip

Related repos

• Core dependency: https://github.com/Raph563/NerdCore
• Product workflows addon: https://github.com/Raph563/ProductHelper