From 5b17d28f66ef6bb8525d3a848e0428f43da16a4e Mon Sep 17 00:00:00 2001
From: Kyle Bolen <kbolen@amazon.com>
Date: Tue, 28 Jul 2026 03:56:54 +0000
Subject: [PATCH] docs: document PTPCamera + AMPDeviceDiscoveryAgent conflict
 and fix

---
 README.md | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 8ba2d3d..230accf 100644
--- a/README.md
+++ b/README.md
@@ -65,13 +65,28 @@ java -jar build/compose/jars/photophetch-macos-*.jar
 
 ## iPhone notes
 
-When you plug in an iPhone, macOS's built-in `PTPCamera` daemon may grab the device before gphoto2 can. If PhotoPhetch finds the device but shows no photos:
+When you plug in an iPhone, macOS's built-in `PTPCamera` and `AMPDeviceDiscoveryAgent` daemons grab the device before gphoto2 or ADB can. Symptoms: "Could not connect to device" errors, Image Capture showing the phone under DEVICES with nothing listed, or `LOC:something` entries cycling in Image Capture.
+
+Kill them before scanning:
 
 ```bash
 killall PTPCamera
+killall AMPDeviceDiscoveryAgent
 ```
 
-Then rescan in the app.
+Close Image Capture first if it's open. Then rescan in PhotoPhetch.
+
+To stop them from re-grabbing the device on every USB connect (recommended if you use PhotoPhetch regularly):
+
+```bash
+launchctl unload -w /System/Library/LaunchAgents/com.apple.ptpcamera.plist
+```
+
+To re-enable Image Capture later:
+
+```bash
+launchctl load -w /System/Library/LaunchAgents/com.apple.ptpcamera.plist
+```
 
 ### HEIC settings