#Scanning — Barcodes, Receipts & Photos

Point your camera at practically anything and the app will figure out what it is. It's the fastest way to fill your inventory, and it's more than a little bit magical.

#What It Does

Smart Scan is the AI-powered camera at the heart of ambientChat.ai. It doesn't just take photos — it understands what it's looking at. Point it at a barcode and it looks up the product. Point it at a receipt and it extracts every line item, price, and store name. Point it at a shelf full of spice jars and it identifies each one individually.

Everything it recognizes gets added to your inventory automatically, complete with names, categories, estimated prices, and expiry dates where applicable. You scan, it catalogs. The division of labor is quite civilized.

#How to Use It

#iOS App

#Basic Scanning

Tap the Scan tab at the bottom of the screen
Your camera activates with the Smart Scan viewfinder
Point the camera at what you want to scan
Tap the shutter button (large circle at the bottom center)
The screen briefly freezes to confirm capture, then returns to the viewfinder
Your item is uploaded to the server for processing — you'll see a progress indicator at the top of the screen

You can scan multiple things in quick succession. Each capture is queued and processed in the background, so you don't have to wait between shots.

#Barcode Scanning

For products with a UPC or EAN barcode:

Open the Scan tab
Point the camera at the barcode — the viewfinder will recognize it automatically
Tap the shutter button to capture
The barcode is decoded and the product is looked up in a global product database
If found, the item is created with full product details: name, brand, category, image, and often nutritional or ingredient data

Barcodes work best when:

The barcode is flat and not crumpled
You're close enough that the barcode fills at least a third of the viewfinder
The lighting is even (no harsh shadows across the bars)

#Receipt Scanning

For paper receipts:

Lay the receipt flat on a surface (a table, counter, or even the floor works fine)
Open the Scan tab
Position the camera so the entire receipt is visible in the viewfinder
Tap the shutter button
The AI reads the receipt and extracts:
- Store name and location
- Date of purchase
- Individual line items with descriptions and prices
- Total amount
Each line item becomes a separate inventory entry, and a receipt document is created linking them all together

For long receipts, you may need to take multiple photos. The AI is quite good at figuring out what's a product name and what's a tax line or subtotal.

#Photo Scanning (Products & Items)

For anything that doesn't have a barcode, or when you want to scan multiple items at once:

Open the Scan tab
Point the camera at the item or group of items
Tap the shutter button
The AI analyzes the image and identifies what it sees
Each detected item becomes an inventory entry

Multi-item detection is one of Smart Scan's best tricks. Take a photo of your medicine cabinet, a shelf of pantry items, or a collection of tools, and it will try to identify each item individually. One photo, many inventory entries.

#Camera Controls

Flash toggle — Tap the lightning bolt icon to cycle the flash on or off. Useful in dim environments.
Help overlay — A rotating overlay appears briefly every cycle (10 seconds visible, then fades for 40 seconds) showing you what Smart Scan can detect: Receipts, Products & Items, and Barcodes. It's a gentle reminder, not a demand for attention.

#BLE Tag Scanning

There's a separate scanner for Bluetooth Low Energy (BLE) tags — small wireless tags attached to physical products that carry Digital Product Passport (DPP) data.

From the Scan tab, tap the Bluetooth icon in the top corner
The BLE tag scanner opens, searching for nearby broadcasting tags
Detected tags appear in a list with signal strength
Tap a tag to read its product data and add it to your inventory

This is a specialized feature — you'll only use it if you encounter products with BLE-enabled tags (common in retail pilot programs and smart packaging).

#What Happens After You Scan

Immediate: The scan is submitted to the server. You'll see a brief "Submitting..." indicator.
Processing: The server analyzes the image using AI. This typically takes 5-15 seconds, depending on complexity.
Complete: New items appear in your inventory under a "Just Added" section. A notification confirms what was found.
Documents: A source document (receipt, product scan, etc.) is also created and linked to the inventory items. You can find it in the Documents sub-tab under Context.

You can keep scanning while previous items are still processing. The app handles the queue gracefully.

#Via Chat

You can also add items through conversation:

"Add a bottle of olive oil to my inventory"
"I just bought 3 AA batteries at Walgreens for $8.99"

The AI will create inventory entries based on your description. It's not as rich as scanning (no barcode lookup, no image analysis), but it works in a pinch.

#Via Claude Desktop (MCP)

Through the MCP connection, you can use:

ambientchat_process_image — Submit an image URL for scanning and inventory creation. Works with product photos, receipts, and barcodes.

Example: "Process this image of my grocery receipt and add everything to my inventory."

#Tips & Tricks

Good lighting makes a real difference. Smart Scan can handle imperfect conditions, but well-lit, clearly visible items produce dramatically better results. Natural daylight is ideal; harsh overhead fluorescents are the enemy of receipt scanning.
Hold the camera steady for a moment before tapping. The capture is instant, but giving the autofocus a beat to lock on produces a sharper image, which produces better AI recognition.
Receipts work best flat and complete. Crumpled receipts, partial captures, or photos where your thumb obscures the total will still work — but results improve significantly with a flat, fully visible receipt. Smooth it out, pin down the curling edges, and your accuracy will thank you.
Scan in batches, review later. You don't have to verify every item as it's scanned. Blast through a pile of products, then visit the Inventory tab to review and correct anything the AI got wrong. It's faster and more satisfying.

#Options

Setting	What It Does	Default
Camera Flash	Toggle flash on/off during scanning	Off
Help Overlay	Rotating tips about what Smart Scan can detect	On (cycles automatically)
BLE Tag Scanner	Separate scanner for Bluetooth product tags	Available via Bluetooth icon

#Known Limitations

Handwritten receipts are challenging. The AI can handle printed thermal receipts well, but handwritten notes, invoices, or receipts from very old dot-matrix printers may produce incomplete or inaccurate results.
Very blurry or dark images may fail. If the AI can't make out what's in the photo, it will let you know rather than guess wildly. Retake with better lighting or a steadier hand.
Maximum of about 20 items per photo. Multi-item detection works well for reasonable groups, but photographing an entire warehouse aisle will hit practical limits. For large collections, take multiple focused photos.
Barcode lookup depends on the product database. Obscure, local, or very new products may not be in the global UPC database. In those cases, the AI falls back to visual identification from the photo.
Processing requires an internet connection. All image analysis happens on the server, so scanning in airplane mode or areas with no signal won't work until connectivity is restored. The app will queue the scan and submit it when you're back online.
Thermal receipt paper fades. This isn't our fault, but it's worth mentioning: if you've got receipts you want to keep, scan them sooner rather than later. The app preserves the data even after the paper becomes an illegible grey smudge.

#Version History

Version	Date	What Changed
1	2026-03-01	Initial guide

Scanning — Barcodes, Receipts & Photos