Add Lab gamma darkening and optional 1.5x cubic upscale (crops under 1800px) so faint TD-style ribbon ink is readable without slowing sharp captures. Add .gitleaks.toml so the pre-commit secret scan can load default rules.
- vision/document.py: pad_quad() expands the detected quad outward
before warping so a straight-line contour fit doesn't clip the first
character of every line on a slightly curled/wrinkled receipt
- ocr/extract.py + llm/vision.py: extract transaction time (HH:MM) so
same-day repeat visits to a vendor get distinct filenames
(2023-03-20_1525_walmart.pdf vs. a later same-day trip)
- vision/orient.py: downscale before Tesseract OSD/confidence-sweep
rotation detection — this was the dominant cost in the detection
phase (7x speedup: 472s -> 67s on a 36s test video)
- vision/refine.py: tighten crops to the paper band (removes mat
margins and hands beside receipts) and inpaint border-connected
skin regions so fingers disappear from output
- llm/vision.py: identify documents with a local Ollama vision model
(qwen2.5vl); extracts vendor/date/total/form code and flags quality
issues (fingers, blur, glare); falls back to Tesseract when down
- pipeline: drop blank pages, dedupe consecutive captures of the same
document, record refine/LLM fields in report and export summary
- ocr/: Tesseract-based vendor/date/total extraction. PSM 6 (single
uniform text block) instead of the default fixes receipts where
item-name/price columns were otherwise split into separate blocks and
dropped. Vendor line picked by median (not max) word height within the
top fraction of the crop, breaking ties by topmost line - max() was
fooled by single descender/ascender glyphs (commas, parens) inflating
one word's bounding box.
- naming/: merge OCR metadata into YYYY-MM-DD_vendor.pdf filenames,
degrading gracefully to UNSORTED_<timestamp>.pdf; per-run dedup.
- pdf/: img2pdf-based multi-page-capable assembly (images_to_pdf).
- pipeline.run_export(): OCR + name + PDF each detected crop from a
detect() report, writes pdf/ and export_summary.csv.
- New `paperpod export <video>` CLI command.
- Verified against synthetic Home Depot/Metro/Petro-Canada receipts:
3/3 correct vendor, date, and total after tuning.
Known limitation (documented in README): no page-flip/multi-page
grouping yet (that's events/, still unbuilt) - every detected document
becomes its own single-page PDF.
Renders three thermal-paper style receipts with real text (Home Depot,
Metro, Petro-Canada) placed one at a time on a black mat with hand motion
and drop shadows, matching the recommended real-world recording setup.
Verified: detect finds all 3 receipts, 7 stable windows, clean crops.
