DKSpoonVault — User Guide

A private, offline catalog for your souvenir spoons. (Fridge magnets have their own app — DKMagnetVault.) This guide walks through every feature and setting, step by step.

In a hurry? The whole app in one line: on the home screen tap +, choose Take photo, drag the box around your spoon, tap Remove background, then Save. Everything below is optional.
Contents
  1. First launch
  2. Adding a spoon
  3. The cut-out tools
  4. Filling in the details
  5. Optional Claude AI
  6. 3D: living sticker & spin
  7. Browsing your collection
  8. Map & Stats
  9. Backup & Restore
  10. Settings reference
  11. Privacy & your data
  12. Tips & troubleshooting

1. First launch

The first time you open the app you'll see a one-time welcome screen explaining the three things it does — snap a photo and it cuts the spoon out automatically, organize and explore your collection, and stay private & offline. It offers two ways in: tap No — get started offline to jump straight into the app (everything works without an account), or Yes — set up Claude AI if you want to set up optional auto-tagging first (you can always do this later in Settings). You can also tap the New here? Read the guide link to open this guide. You won't see this welcome screen again.

You can reopen this guide any time from the ⋮ (More) menu → SettingsUser guide.

The app opens to your collection — empty at first, with "Nothing here yet" and a tip to tap the round + button.

No sign-up, no permissions to grant. There's no account and no login. The app never asks for camera, photos, or location permission at runtime — it uses your phone's built-in camera app and photo picker, which handle their own access. Everything works offline out of the box.

2. Adding a spoon

Tap the + button (bottom-right) to open the Add sheet. It asks two quick questions.

Step 1 — Choose a source

Step 2 — How many

After Take photo or Pick from gallery, choose the shape of what you're adding:

ChoiceWhat it does
One spoonOne spoon per photo. Camera: one shot → opens straight into the editor. Gallery: you can actually pick several photos — each becomes its own spoon, and the app walks you through editing them one after another.
Several spoonsOne photo that holds several spoons — the app finds each one and splits it into separate spoons (see the Split editor below).
3D SpoonA few photos of one spoon from different angles — the app builds a swipeable 3D spin (see §6).

Splitting one photo of several spoons

If you chose Several spoons, the Split editor opens. It shows a box around each spoon it found ("N spoons found").

  1. Rotate the photo upright with the corner Rotate left/right buttons if needed.
  2. Tap a box to select it, then drag to move or drag a corner to resize. Pinch to zoom the photo, drag to pan, or twist two fingers to straighten a tilted photo.
  3. Use + Add to add a box the app missed, Delete to remove the selected box, or Split to cut one box into two (for spoons detected as one).
  4. Tap Done (N) — each box becomes its own spoon, and you're walked through reviewing them.

3. The cut-out tools

Whenever you take or choose a single photo, the app immediately opens Confirm the spoon — a box you place around one spoon so it can cut away the background.

  1. Rotate the photo upright with the rotate-arrow icons in the top corners.
  2. Drag the box so it surrounds the spoon, keeping a little background visible on every side (that helps the cut come out clean).
  3. Pinch to zoom, drag to pan, or twist two fingers to fine-straighten a tilted photo.
  4. Tap Remove background. Usually the app cuts the spoon out and adds a subtle white "die-cut sticker" border — die-cut means the clean cut-around-the-edge outline you see on a real sticker — and you'll see "Background removed — Crop or Undo edits if needed." If it can't cleanly separate the spoon (for example the box hugs the spoon's edges, or the background is busy), it instead keeps a plain crop of your box and shows a message suggesting you leave a little background around the spoon and try again.

You can also tap Cancel (bottom-left) in this box to keep the plain photo and skip background removal for now.

Rectangular tiles come out level and rounded. Flat photo-tile spoons are automatically straightened, given clean edges and softly rounded corners, and the sticker border wraps them evenly — so a slightly crooked or angled shot still looks tidy. Sculpted shapes (like a bowl) keep their natural outline.

Back on the editor, once a photo exists you get the full tool row:

ButtonWhat it does
PhotoTake a new picture (replaces the current one and re-opens the cut-out box).
ChoosePick a different photo from the gallery.
Remove backgroundRe-open the box and cut out the background again.
CropTrim the photo — keep whatever's inside the box, then Done.
RotateTurn the photo 90° clockwise each tap.
Undo editsUndo the cut/crop/rotate and go back to the original photo.
Touch up edgesHand-fix the cut-out edges with a brush (see below).

Touch up edges (the brush)

Available right after a successful Remove background. It opens a full-screen brush so you can perfect the edges:

Nothing is saved until you tap Save at the top of the editor. Leaving the screen without saving discards the new photo and edits.

4. Filling in the details

Below the photo, add as much or as little as you like — every field is optional except that a spoon is more useful with a place. Fields include:

After adding a photo you may see a "Photo taken <date> — use as Date acquired?" card; tap Use date or No (a camera photo with no embedded date suggests today's date). When you're done, tap Save. With cloud AI on, Save may briefly read Classifying… and stay disabled for a moment while Claude analyzes the photo — just wait and it returns to Save.

New items are saved as a Draft (they show a "Draft" badge) until you review them. On the detail screen a Draft — tap Edit to finish details banner takes you back here to finish.

5. Optional Claude AI (auto place & tags)

The app is fully usable offline. If you want it to suggest the place and tags automatically, you can turn on cloud AI, which uses your own Anthropic (Claude) API key. It's off by default.

Cloud AI sends each item photo to Anthropic (using your key, billed by Anthropic — a fraction of a cent per photo on the cheapest model). It's for adults (18+). Everything else in the app stays fully offline.

Turning it on

  1. Go to ⋮ (More)Settings.
  2. Under Auto-classification, choose Cloud + on-device. The first time, a Turn on cloud AI? dialog explains what's sent; tap I'm 18+ — enable.
  3. If you don't have a key yet, the Set up Claude AI in 3 steps sheet opens automatically:
    1. Open the Anthropic Console and create a free account.
    2. Add a little billing credit (pay-as-you-go).
    3. Create an API key (it starts with sk-ant-), copy it, and paste it into the field (or tap Paste from clipboard).
  4. Tap Test & save. If the key works it's saved automatically (encrypted on your device) and shows "Key works ✓ — saved." Then tap Done.

Cloud AI only starts working once a valid key is saved. If you choose Cloud + on-device but close the key sheet without a working key, the app quietly keeps using on-device only — so finish the key setup to actually get Claude's suggestions.

How it helps: with cloud AI on, each new photo is sent automatically to suggest a place and tags. You'll see a Suggested location card on the editor — tap Use to apply it, pick an alternative chip, or Dismiss. Nothing is applied unless you tap it. On a saved spoon you can tap Re-classify with Claude to try again.

Related settings (all under Settings): the Confidence threshold slider decides when a guess is shown as confident vs. flagged for review; the Classification model picker (Cloud mode only) trades cost for accuracy (Haiku is fast & cheap and usually enough).

6. 3D: living sticker & spin

DKSpoonVault has two 3D effects, both controlled per-spoon on its detail screen. (A master 3D motion effects switch in Settings — and your phone's system "Remove animations" setting — can turn them all off.)

Living sticker (tilt)

Makes a flat spoon photo subtly tilt in 3D as you tilt your phone. On a spoon's detail screen tap Add 3D movement to turn it on (tap Remove 3D movement to turn it off). It's off until you enable it. This toggle appears only for an item that has a photo and no 3D spin — a spin replaces the flat image, so once you build one the tilt toggle is hidden.

3D spin (swipe to rotate)

Turns several angle photos of one spoon into a rotatable object you can swipe. There are two ways to build it, and they work a little differently:

Either way, use at least 2 angle photos (up to 12), and clearer photos from distinct angles spin best.

On the detail screen, the spin becomes the main image:

Symmetric vs. sculpted: flat rectangular tiles get the clean die-cut border in the spin too; sculpted shapes like a bowl are shown border-less so the outline doesn't shimmer as they turn.

7. Browsing your collection

The home screen shows every spoon as a card, automatically grouped by US state / country / "Unplaced" (with a count per group). From the top bar you can:

Tap a card to open its detail screen. On detail you can swipe left/right through your whole collection (in the current sort/filter order), favorite it, edit, or delete it.

Long-press a card to enter selection mode: tap more cards to select, use Select all, then the 🗑 (Delete) icon to remove several at once. This "select all → delete" is also how you clear everything.

Deleting is permanent — it removes the spoon and its photo, with no undo/trash. Every delete asks you to confirm first.

8. Map & Stats

Map shows your spoons pinned on an OpenStreetMap world map. Spoons at the same place share one pin; tap a pin to see its place name, and if more than one spoon is there the title shows a count. A place needs coordinates to appear; with cloud AI on, the app looks those up automatically for you.

Stats is a read-only summary: total items, US states (out of 50), countries, places, trips, and favorites; an acquired-date timeline line (e.g. "N added this year · collected …"); plus bar breakdowns by state, country, top tags, events, and trip.

9. Backup & Restore

Because everything is stored only on your phone, use Backup to keep a copy or move to a new device. In SettingsBackup & restore:

Restore replaces everything currently on the device with the backup's contents and can't be undone. The backup holds your spoons and photos — but not your settings: after moving to a new phone you'll re-enter your API key and re-set your preferences (cloud AI on/off + the 18+ acceptance, confidence threshold, Claude model, and 3D motion effects all return to their defaults).

10. Settings reference

Reach Settings from the collection's ⋮ (More) menu.

SettingWhat it does
Set up Claude AI / statusEnter, test, and save your own Anthropic API key (encrypted on-device). Shows Ready ✓ or Not set up.
Auto-classificationCloud + on-device (best accuracy, uses your key, sends photos to Claude) or On-device only (fully offline, reads on-item text — the default).
Confidence threshold30–95% slider. Below it, an AI guess is flagged for review instead of shown as confident. You always apply a guess yourself.
Classification modelCloud mode only. Which Claude model identifies items — Haiku 4.5 (fast/cheap, default), Sonnet 4.6, Opus 4.8, or Fable 5. Pricier tiers cost more per photo.
3D motion effectsMaster switch for the living-sticker tilt and spin auto-spin. Turn off for still images. (Your phone's "Remove animations" setting also disables them.)
Back up / RestoreExport/import your whole collection as a .zip (see §9).
Send feedbackOpens your email app to dkspoonvault@gmail.com, adding your app version, device model, and Android version to the message body.
User guideOpens this guide in your browser.
Open-source licensesThe licenses of the libraries the app uses.

11. Privacy & your data

Full details are in the Privacy Policy.

12. Tips & troubleshooting