kbolen/photophetch
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity

docs: document PTPCamera + AMPDeviceDiscoveryAgent conflict and fix

Browse Source
This commit is contained in:
Kyle Bolen
2026-07-28 03:56:54 +00:00
parent 35b98e1857
commit 5b17d28f66
1 changed files with 17 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
README.md
View File

@@ -65,13 +65,28 @@ java -jar build/compose/jars/photophetch-macos-*.jar
## iPhone notes ## 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 ```bash
killall PTPCamera 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 ### HEIC settings