Release v1.0.0

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