#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 (or six album covers laid out on the rug), and it will try to identify each item individually. One photo, many inventory entries.

#Per-Item Photos, Cropped Automatically

When you scan a group of items in one photo, each item gets its own cropped photo — the AI locates every item in the frame and the app cuts out just that item's region. Your Crosby, Stills & Nash record shows its actual cover, not the whole floor. The original group shot is kept too, on the scan's source document, and the "Scanned with N others" strip on any item shows its scan-mates with their own crops.

A few things worth knowing:

When the crop is good, it becomes the item's picture everywhere — the grid thumbnail, the detail page, chat context. No stylized icon is generated for that item (which also makes the scan faster and cheaper).
When a crop can't be trusted — cluttered scenes, partly hidden items — the app plays it safe and keeps the group photo for that item rather than showing you a bad crop.
Want the illustrated look instead? Tap Iconify on the item's detail page and the app draws its stylized 3D icon on demand. Iconify replaces the thumbnail; the photo stays on the detail page.
Sideways photo? Photos taken pointing straight down (flat-lays) occasionally come out rotated — gravity gives the camera no clue which way is up. The app reads the items' own text to guess the right orientation, and if it still gets it wrong, tap Rotate on the item's detail page to turn the photo 90° at a time. The fix shows up on every device.

#Saving Scans into a Folder

Above the shutter you'll see Save to folder? with chips for your recently used folders, a Browse button, and Skip — AI decides. Pick a folder (or create one — you can nest folders, like Music/Vinyl) and every item from your scans lands there, visible on the Inventory tab. The chip stays armed for back-to-back scans, so cataloging a big collection is: pick folder once, then shoot, shoot, shoot.

#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.

#Where the Scan Was Taken

When the app can tell where you were when you scanned — because you're standing near a registered iBeacon, the photo carries GPS in its EXIF metadata, or your phone's location is on — that scene gets stamped onto every item the scan creates as Last seen.

Precedence (strongest signal wins):

Beacon — most precise; pins items to a specific room you've registered.
EXIF GPS in the photo — accurate to where the photo was actually taken, even if you've since walked off.
Your current device location — falls back here when the photo has no GPS.

If none of those is available — say you've denied location permission and there's no beacon nearby — the scan still works, items just don't get a "Last seen" stamp. Nothing breaks. You'll just lose the ability to ask "what's in the kitchen?" for those particular items.

#Web

You can add things from the web interface at app.ambientchat.ai too — by upload rather than a live camera:

Open the Scan page
Click Choose Files and pick one or more images, PDFs, or .md files (up to 20MB each)
Pick a destination folder (defaults to My Documents)
The AI processes each file and creates inventory items and/or documents, just like a phone scan

On a phone browser you'll also see Take Photo and Photo Library buttons; on desktop there's no live camera, so use Choose Files.

#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
3	2026-06-07	Added Web section — uploading photos/PDFs/markdown via the web interface
2	2026-05-01	Added "Where the Scan Was Taken" — beacon/EXIF/GPS precedence, last_seen stamping
1	2026-03-01	Initial guide

Scanning — Barcodes, Receipts & Photos