What do I see the first time I open the app?

You see an Apple Map with blue dots and country flags. Those dots are photo locations loaded from iCloud over time. By default the app uses your full iCloud history; you can narrow the date range in Settings. Four icons in the top-right corner open Achievements, Travel Plans, Settings, and Share.

What can I do with a photo spot (a small blue dot)?

Tap a spot to select it—it turns orange and shows the photos taken there. Tap “Add a short memory for this moment…” to write or dictate a note.

  • Typing: you can use any language you like.
  • Speak: on-device speech recognition follows your iPhone or iPad language settings (Settings → General → Language & Region). It only works reliably for languages Apple supports for that configuration.

These notes are packaged into llm_task_prompt.txt for your preferred LLM to polish into a travel memoir with photos, which you can preview in the app and export as a PDF.

What do the map dot colors mean?

  • Blue — no story yet for that photo location.
  • Green — has a story and is included in the PDF / memoir export by default.
  • Red — has a story but is excluded from PDF export.
  • White with a blue border — the photo is hidden on the map.

What are the four icons in the top-right corner?

A — Footprint & Achievements
B — Travel Plans
C — Settings
D — Share (exports and sharing)

The sections below explain each one.

A. Footprint & Achievements — what does it do?

It shows how many countries and territories you have visited (out of the app’s full list), your highest altitude from photo metadata (excluding hidden photos), and a breakdown by place. Visits are inferred automatically from your photos’ GPS data; you can manually add or remove countries if something looks wrong.

B. Travel Plans — what does it do?

Plan future trips by year: countries and territories, or UNESCO World Heritage sites you intend to visit. Plans appear on the map as pulsing markers with a color per year. Countries use their flags; UNESCO sites use a dedicated marker style.

C. Settings — Part 1: data, range, and map overlays

  • Photo time range — choose how much of your iCloud photo history to scan for locations (default: all time). This controls which photos become pins on the map and the “location points” counts in Settings.
  • Google Takeout — see the FAQ section “Google Takeout (JSON and JPG/HEIC)” for import details.
  • Statistics — counts of location points within the active scan/filter range.
  • Map — choose which travel-plan years appear (default: All). Toggle visited-country flags and the highest-altitude marker (both on by default).

Achievements (visited countries, highest altitude, and the Achievement PDF) intentionally use your lifetime footprint across scans, so narrowing the scan does not erase past peaks or countries you already unlocked. Highest altitude ignores hidden photos; see the FAQ entry “Highest altitude and in-flight photos.”

Highest altitude and in-flight photos

Highest altitude uses GPS elevation from your photos across all scans (not limited by scan date range). Cabin or in-flight photos often report very high altitudes (for example above 10,000 m).

Hidden photos (white dot with blue border) are excluded from the highest-point calculation. The mountain marker on the map, the Achievement highest-altitude stat, and map snapshot stats update immediately when you hide or restore a photo. If you hide the current highest photo, the next-highest non-hidden photo takes its place; restoring that photo brings the title back when it is still the highest among visible photos.

Hiding a photo does not change visited-country flags or counts. For in-flight shots you do not want counted as your travel peak, hide them on the map.

C. Settings — Part 2: which dots appear on the map?

You can independently show or hide four kinds of pins: blue (no story), green (included in PDF), red (story but PDF off), and white with blue border (hidden photo).

For Travel Memoir exports, only green dots (included in PDF) are used. Before exporting, try showing only greens to confirm the photos and mood notes match the trip you want in the book—this also gives your LLM cleaner material. Under LLM Output you can ask the export prompt to target your story language or English.

D. Share — what can I export or send?

Tap the Share icon (top-right). The sheet groups exports into Story → PDF memoir, Map, and Lists. Use the numbered items below.

1. Story → PDF memoir (iPhone or iPad)

Before you start: on the map, add a short story to the photos you want in the book and leave them as green dots (included in PDF). Red dots (story but PDF off) and hidden photos are not exported.

Step (1) — Save export folder — LLM prompt

  • Tap Step (1). The app builds a folder with your selected stories and photos.
  • In the share sheet, save the whole folder to Files (or another app). Keep every item together.
  • Main files: llm_task_prompt.txt (copy this into your LLM), mapping.json, manifest.json, photos/, memoir.md, and memoir_template.html.
  • Open llm_task_prompt.txt in ChatGPT, Claude, Gemini, or another LLM. Send it as the task. The model should reply with structured JSON (sections, narratives, photo_ids)—not plain prose only.
  • Tip: In Settings → LLM Output you can ask for your story language or English in that prompt file.

Step (2) — Memoir preview — paste, Render, PDF (on device)

  • Tap Step (2). The app exports the same package and opens an in-app preview (mapping and photos are already loaded).
  • Paste the LLM’s full reply into the text box.
  • Tap Render Memoir. Check the layout and photos.
  • Tap Export PDF in the preview toolbar. Share or save the PDF like any other file.

Optional — Share Story as ZIP for Mac or PC

  • Use this if you prefer a computer browser or want to email one file.
  • Tap (Optional) Share Story as ZIP. Save or AirDrop the .zip.
  • On Mac or PC: unzip so you see llm_task_prompt.txt, mapping.json, photos/, and memoir_template.html in one folder.
  • Run the LLM on llm_task_prompt.txt on the computer (same as Step (1)).
  • Open memoir_template.html from inside that unzipped folder (double-click in Finder). If photos do not show in Safari, try Chrome, or in Terminal from that folder run: python3 -m http.server 8765 and open http://localhost:8765/memoir_template.html
  • Choose mapping.json if the page asks for it, paste the LLM JSON reply, tap Render Memoir, then Export PDF in the page (or use the files however you like).

2. Share Map Snapshot (visited countries)

  • Creates a shareable map image (JPG) of your footprint—not a PDF list.
  • Includes visited-country flags and location pins that match your current map filters and dot visibility settings.
  • You choose Map Style (light or dark) and Map Coverage (Asia Pacific, EMEA, or Americas).
  • Tap Generate, then share or save the image via the system share sheet.

3. Export Travel Plan (PDF)

  • Exports your future plans from the Travel Plans screen: countries/territories and UNESCO sites, grouped by plan year.
  • Produces a styled Letter-size PDF (header, stats row, two-column layout).
  • Share to Files, Mail, or AirDrop like any PDF. This is separate from the Story → PDF memoir steps above.

4. Export Achievement List (PDF)

  • Exports places you have already visited (from photo GPS, plus any manual corrections in Achievements).
  • Lists countries/territories by continent with flags, plus summary stats (count visited, world explored %, highest altitude).
  • Uses your cumulative achievement history, not only the current photo scan range.
  • Same styled PDF format as Travel Plan. Share like any PDF.

Shared iPhone or iPad — switch users with backup & restore

PlatMemoir supports any number of people on the same device. There is no fixed “user slot” limit—you keep one backup file per person (or per trip) and restore the right file when needed.

When to use this

  • A family iPad or classroom device where different people sign in with different Apple IDs over time.
  • Reinstalling the app or moving to a new device while keeping stories, Google map pins, travel plans, and achievement data.

Settings layout

  • Switch iPhone/iPad user — Step 1 export, then Step 2 clear. Clear stays locked until you save the .zip and tap “Yes, unlock Clear” (the app will not let anyone clear without that backup step).
  • Backup restore & Google photos — restore a saved .zip when you come back (does not use Clear). Google Reconnect is only if pin previews stay blank after restore.

Recommended workflow (hand off to someone else)

  1. Settings → Switch iPhone/iPad user → Step 1: Export handoff backup.
  2. In the share sheet, save the .zip to Files or iCloud Drive. When asked, tap “Yes, unlock Clear” only after the file is really saved.
  3. Rename the file so you can tell users apart—for example: PlatMemoir_Handoff_Backup_Alex_2026-05-18.zip or PlatMemoir_Handoff_Backup_Mom_2026-05-18.zip. The app exports a generic name; renaming in Files is up to you and strongly recommended on a shared device.
  4. Step 2: Clear all PlatMemoir data (does not delete Apple Photos or Google Takeout folders on disk).
  5. The next person signs in, allows Photos, and scans iCloud in Settings → Data Sources.

Restore (same person coming back or after reinstall)

Use this when you return to a shared device, get a new iPhone/iPad, or reinstall the app and want your own PlatMemoir data back—not when you are handing the device to someone else for the first time (they use their Apple ID and scan iCloud, or restore their own .zip).

You do not use Clear when you come back. Clear only exists inside Switch iPhone/iPad user and only unlocks after that screen’s export-and-save step. While someone else’s data (or a fresh empty app) is on the device, you are not meant to Clear first—you pick your own .zip under Backup restore & Google photos and Restore replaces what is on the device with your backup.

  1. Settings → Backup restore & Google photos → Restore from backup… and pick the correct .zip (use your name/date in the filename to choose the right one).
  2. Allow Photos access and tap Scan iCloud Photos if you use iCloud pins.
  3. Open the map and confirm your blue (iCloud) and Google pins look right before you rely on the data again.
  4. Only if Google pin previews are blank: Settings → Backup restore & Google photos → Google Reconnect, then pick the Takeout folder that contains your JPG/HEIC files (e.g. after moving Takeout or on a new device).

What is (and is not) in the backup

  • Included: stories, map pin metadata (Google and, in newer backups, iCloud points), travel plans, visited countries, PDF include/hide flags, achievement altitude, Google folder bookmarks.
  • Not included: your full iCloud photo library or Google image files on disk—you still need Photos access; Google previews use your Takeout folder on this device (often restored automatically from the backup’s folder bookmark).

Tips

  • You can keep many .zip files in Files—one per family member or per export date.
  • Leaving vs coming back: before you hand the iPad to someone else, use Switch user → Export (save the .zip, rename it with your name and date) → Clear. When you come back later, use only Backup restore → Restore from backup—no Clear step.
  • When is Clear used? Only the person who is leaving, and only after they export and confirm the backup on the Switch user screen. Clear wipes PlatMemoir’s local database so the next person does not see the leaver’s stories, pins, or plans. It does not delete photos in Apple Photos or files in your Google Takeout folder.
  • If the next person will restore their own .zip, Restore also replaces what is on the device—but the leaver should still Clear after export so the next person does not briefly see the previous map before they restore.

Google Takeout (JSON and JPG/HEIC) — how does it work?

Google Takeout lets you download your Google Photos metadata (and optionally image files). PlatMemoir can add those locations to the same map as iCloud photos.

What to import

  • In Settings → Google Takeout JSON, tap Import and select a .json file or a folder from your Takeout download.
  • The app imports location data from JSON files only. It does not copy your whole photo library into the app.

JPG, HEIC, and folders

  • If you select a Takeout folder that also contains JPG or HEIC files next to the JSON, the app remembers that folder.
  • When you tap a Google-sourced pin on the map, PlatMemoir loads the matching image from that folder on demand.
  • Keep the JSON and image files in the same Takeout folder structure on your device or drive. If images move, pins may stay but photos might not open.
  • After a handoff restore, Google previews often work without extra steps. If a pin preview stays blank, use Settings → Backup restore & Google photos → Google Reconnect and pick your Takeout folder again (common after moving Takeout or reinstalling the app).

Date range

  • Google points follow the same scan range as iCloud: Full Range or Select Range in Settings → Data Sources.
  • Narrowing the range filters which Takeout points are kept, similar to iCloud.

On the map

  • Google locations appear as pins like iCloud photos. You can add stories, include them in PDF export, and use them in the Story → PDF memoir flow if they are green dots with stories.

Videos (MOV/MP4) in the folder are detected but not imported as map pins; only JSON geotags create points.