@mcesystems/usbmuxd-instance-manager 1.0.73 → 1.0.75

package/README.md

@@ -108,19 +108,22 @@ await service.stop();
 | `wslDistribution` | string | `usbmuxd-alpine` | Alpine WSL2 distribution name |
 | `verboseLogging` | boolean | true | Enable verbose output |
 | `appleVendorId` | string | '05AC' | Apple vendor ID (hex) |
-| `lockdownWindowsPath` | string | `C:\ProgramData\mce\lockdown` | Windows folder for lockdown (pairing) files; synced to/from Alpine |
-| `lockdownSyncEnabled` | boolean | true | Sync lockdown files so pairing can be skipped |
 
 ### Lockdown sync
 
-When enabled, the manager syncs lockdown (pairing) files between Windows and Alpine so devices that were already paired on Windows can be used without pairing again in WSL:
+The manager automatically syncs lockdown (pairing) files between the native Apple/iTunes lockdown directory and Alpine so devices that were already paired on Windows can be used without pairing again in WSL.
 
-- **To Alpine**: When a device is assigned, that device’s plist (`{UDID}.plist`) is copied from `lockdownWindowsPath` to Alpine `/var/lib/lockdown`. Only the file for that device is copied.
-- **From Alpine**: When the service stops, plists for all devices that were assigned this session (plus `SystemConfiguration.plist` if present) are copied from Alpine back to `lockdownWindowsPath` so they are available for the next run.
+The lockdown directory is resolved per platform:
+- **Windows**: `C:\ProgramData\Apple\Lockdown` (same directory used by iTunes / Apple Mobile Device)
+- **macOS**: `/var/db/lockdown`
+- **Linux**: `/var/lib/lockdown`
 
-**Alpine permissions**: `/var/lib/lockdown` is often root-owned. The sync tries a normal copy first; if that fails (e.g. permission denied), it retries with `sudo cp`. Ensure the WSL user has passwordless sudo for these commands, or that the Alpine image has `/var/lib/lockdown` writable by the default user. If both fail, a warning is logged and device assignment continues (pairing can still be done manually).
+Sync behavior:
+
+- **To Alpine**: When a device is assigned, that device's plist (`{UDID}.plist`) and `SystemConfiguration.plist` are copied from the Apple lockdown directory to Alpine `/var/lib/lockdown`.
+- **From Alpine**: When the service stops, plists for all devices that were assigned this session (plus `SystemConfiguration.plist` if present) are copied from Alpine back to the Apple lockdown directory so they are available for the next run.
 
-Set `lockdownSyncEnabled: false` or leave `lockdownWindowsPath` empty to disable lockdown sync.
+**Alpine permissions**: `/var/lib/lockdown` is often root-owned. The sync tries a normal copy first; if that fails (e.g. permission denied), it retries with `sudo cp`. Ensure the WSL user has passwordless sudo for these commands, or that the Alpine image has `/var/lib/lockdown` writable by the default user. If both fail, a warning is logged and device assignment continues (pairing can still be done manually).
 
 ## CLI Options
 
@@ -212,7 +215,7 @@ The instance manager does steps 2–3 automatically when it sees an iOS device.
 2. **Unbind** so Windows gets the device back:  
    `usbipd unbind --busid <BUSID>`
 
-Until you unbind, the device stays “Shared (forced)” and Windows/iTunes will not see it.
+Until you unbind, the device stays "Shared (forced)" and Windows/iTunes will not see it.
 
 ### Useful usbipd commands