2.6 KiB
iOS config transfer
Requires Xcode, Python 3, a development build with FaceclawConfigPort, and an
unlocked/trusted iPhone. Both commands restart Faceclaw, briefly interrupting its
Bluetooth and Terminal sessions.
scripts/pull_config_ios.sh # faceclaw_settings.ios.json
scripts/push_config_ios.sh # import the edited file
scripts/pull_config_ios.sh -f /tmp/settings.json --device IPHONE_UDID
scripts/push_config_ios.sh faceclaw_settings.xml # Android pull_config.sh output
Use --device / -d or set IOS_DEVICE when more than one device is connected.
Without either, the script selects the only device with an active Xcode tunnel.
For the simulator, add --simulator (defaults to booted; --device selects one).
The JSON format preserves setting types:
{
"schema": 1,
"settings": {
"terminal.connections": "[]",
"terminal.autoReconnect": true
}
}
Pull accepts an .xml output filename to write Android shared-preferences XML.
Push detects JSON or XML by content and supports strings, booleans and numbers.
Malformed input, unsupported values and files over 2 MiB fail before restarting
the app. Push merges supplied keys, preserving omitted settings (including
phone-specific pairing). To clear a value, supply its empty/default value.
Transfers use devicectl app-container access. The app consumes a uniquely
identified request at bootstrap, before loading settings getters and workers;
it applies imports through NSUserDefaults rather than overwriting a plist that
cfprefsd could restore from cache. Each successful push first saves the previous
preferences to Library/FaceclawConfigPort/previous.plist. Replies are checked
against the request ID, so a stale export cannot appear to confirm an import.
Exports may contain API keys and Terminal tokens. Scripts do not print values, write local exports with mode 600, and remove their private temporary directory on exit. Default export filenames are gitignored. Device request/reply/backup files stay in the private Library directory, outside Files/Finder Documents.
Terminal's configured g2mirror:// scheme uses plain WebSockets; g2mirrors://
uses TLS. The iOS build declares local networking and an explicit ATS exception
for the current development server 100.68.94.67. On iOS 17+, another literal IP
requires its own build-time NSExceptionDomains entry, or a TLS endpoint. The
exception does not disable TLS certificate verification. See Apple's
IP exception rules.