Eats by Snorlax

Kuma Photos

Getting camera-roll photos onto the food map. One thing to double-click.

Start it

In the eats folder on your Desktop, double-click:

Kuma Photos.command

A Terminal window opens — leave it there — and your browser opens the app. Close that window when you’re done.

First time only, macOS may say it’s from an unidentified developer: right-click the file → Open → Open.

What you’ll see

1. Where you stand — how many places have photos, how many need words, and which restaurants have photos on your phone that aren’t on the site.
2. Start picking — your food photos grouped by meal. Narrow by year or city from the dropdowns. Click the good ones, shift-click one to make it the cover, type the restaurant name if it guessed wrong.
3. Add to the site — the green button at the bottom. No downloading or re-uploading anything.
4. Look at more years — only when you want photos further back. About two minutes a year. 2021–2026 is already done.

In the picking screen

• click — keep this photo. Click again to drop it.
• shift-click — make it the cover, the one that shows on the site.
• type a name — the name is a GPS guess. Correct it and it creates that restaurant for you.
• faded tile — still in iCloud, not on this Mac. Can’t be used yet.
• “check this one” — a shaky GPS match. Look at these first.

When it goes wrong

Browser didn’t open — go to http://127.0.0.1:8731 yourself. The Terminal window has to stay open.

“Address already in use” — it’s already running in another window.

Picking screen looks empty — a filter is still set. Year → all, City → everywhere.

Photos on the wrong restaurant — expected. GPS takes the nearest pin within 40m even when the real place was never on the map. Type the real name.

“cwebp missing” — quit the app, run brew install webp libtiff, start again.

Can’t read the photo library — Full Disk Access got switched off. System Settings → Privacy & Security → Full Disk Access → Terminal, then quit Terminal and start the app again.

After adding photos

The app writes files but doesn’t publish. In Terminal:

cd ~/Desktop/eats
git status          # see what changed

Then commit, or ask Claude to.

If you’d rather type

The app covers all of it, but these still work:

cd ~/Desktop/eats
python3 tools/app.py                  # same as double-clicking
python3 tools/photo-status.py         # where things stand
python3 tools/photo-scan.py --scan 2021 2026
python3 tools/photo-picker.py --candidates
python3 tools/photo-import.py ~/Downloads/selections.json --apply
python3 tools/rename-place.py --apply old-slug "Correct Name"

Notes

Everything runs on your Mac — the app only listens on 127.0.0.1 and nothing is uploaded anywhere. Originals stay in Photos; only shrunk copies go on the site.