Karttapallo

Globe view of an Apple Photos library — fix missing locations and wrong dates or timezones in place.

Photos and videos can be browsed in a built-in full-screen lightbox.

Setup

Requires macOS, Bun, and Apple Photos with geotagged photos.

bun install
bun dev

To build and install to /Applications:

bun run cert --create   # one-time: create a self-signed code-signing cert
bun install:app         # build, sign, and copy to /Applications

Then grant the installed app Full Disk Access (System Settings ▸ Privacy & Security). Without signing + FDA, macOS re-asks for the "access data from other apps" permission on every launch and shows the app as "launcher" — see Gotchas.

Optional API keys

Add either to .env to unlock extra features. Both are optional.

PUBLIC_MML_API_KEY=your-key   # MML — Maasto/Orto basemaps
PUBLIC_ORS_API_KEY=your-key   # OpenRouteService — Drive/Hike routing

Get keys from MML and OpenRouteService.

Docs

• CONTEXT — terms and relationships
• App — code shape and seams
• Flows — interaction inventory
• Gotchas — non-obvious behaviors
• Testing — five-tier strategy
• ADR — architectural decisions
• Diary — chronological log