photophetch/releases/v1.0.0.md

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