From 29595d5a7fd179ea15e400713e076f34061d5874 Mon Sep 17 00:00:00 2001 From: Kyle Bolen Date: Sun, 2 Aug 2026 03:53:04 +0000 Subject: [PATCH] Release v1.0.0 --- releases/v1.0.0.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 releases/v1.0.0.md diff --git a/releases/v1.0.0.md b/releases/v1.0.0.md new file mode 100644 index 0000000..b0fef52 --- /dev/null +++ b/releases/v1.0.0.md @@ -0,0 +1,46 @@ +## PhotoPhetch v1.0.0 — First Release + +PhotoPhetch is a macOS desktop app for importing photos from Android and iPhone phones into a PhotoPhile staging directory. + +### Features + +**Android (Samsung, Pixel, and others)** +- Connects via ADB — scans all DCIM and Pictures subfolders automatically +- Smart filtering: excludes Screenshots, Screen Recordings, WhatsApp, Telegram, and other app folders +- Folder structure preserved on import (Camera/, Screenshots/, etc.) +- Thumbnails loaded and cached locally + +**iPhone** +- Connects via pymobiledevice3 (AFC protocol) — works on iOS 17+, no gphoto2 needed +- Photos classified by filename pattern: Camera, Edited, Videos, Screenshots +- Live Photo detection: companion MOV files hidden from grid, HEIC stills show LIVE badge +- Atomic import/delete: HEIC and its MOV companion treated as a unit +- Thumbnails batch pre-fetched newest-first and cached permanently + +**Import flow** +- Browse photos in a two-panel layout: folder jump list on left, dense photo grid on right +- Date markers on first photo of each day; +/- buttons to adjust grid density +- Tap + on any photo to preview full-size (HEIC converted to JPEG via sips) +- Select individual photos, entire days, or entire folders +- SHA-256 copy verification; size-based verification when remote hash unavailable +- EXIF Make verification via exiftool: flags photos with absent Make as unverified + +**Verify screen** +- Per-file status: green (verified), yellow (origin unknown), red (failed) +- Filter by: All / OK / Unverified / Failed +- Thumbnail chip on each row — click to preview +- Soft-remove any file with undo before committing +- Single Done button commits all actions: delete from phone + clean staging + +**Settings** +- Staging path with native macOS folder picker +- Folder name template with {date} and {device} tokens +- Auto-increments folder name if it already exists (e.g. 2026-07-28_iPhone15Pro_2) +- Persists HEIC conversion, folder structure, and other preferences + +### Requirements +- macOS (Intel or Apple Silicon) +- Java 17+ +- ADB for Android: brew install android-platform-tools +- pymobiledevice3 for iPhone: brew install pipx && pipx install pymobiledevice3 +- exiftool for EXIF verification (optional): brew install exiftool