https://github.com/rec0de/watchwitch-ios-companion
Swift companion app for the watchwitch tweak, allowing export of Apple Watch keys and rerouting of WiFi communication
https://github.com/rec0de/watchwitch-ios-companion
Last synced: about 1 year ago
JSON representation
Swift companion app for the watchwitch tweak, allowing export of Apple Watch keys and rerouting of WiFi communication
- Host: GitHub
- URL: https://github.com/rec0de/watchwitch-ios-companion
- Owner: rec0de
- License: other
- Created: 2023-05-22T12:09:17.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-12-15T16:02:49.000Z (over 2 years ago)
- Last Synced: 2024-04-19T22:45:46.909Z (about 2 years ago)
- Language: Swift
- Size: 1.6 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# WatchWitch iOS Companion
Swift companion app for the WatchWitch tweak, allowing export of Apple Watch keys and rerouting of WiFi communication.
## Usage
Make sure the [WatchWitch iOS tweak](https://github.com/rec0de/watchwitch-ios) is installed on your iPhone.
Make sure [Theos](https://theos.dev/docs/) is installed on your computer. Dependencies and version incompatibilities can be tricky on linux, macOS might work more smoothly.
You will also need [Cephei](https://hbang.github.io/libcephei/) installed on your iPhone. To use Cephei with Swift, you may have to copy the [module maps](modulemaps) to your `$THEOS/vendor/lib` folder, e.g. `cp modulemaps/Cephei/* $THEOS/vendor/lib/Cephei.framework/Modules`. This may not be necessary anymore with current versions of theos.
Install the app:
```
iproxy 2222 22
export THEOS_DEVICE_IP=localhost
export THEOS_DEVICE_PORT=2222
make package install
```
Open the app, you should see the tweak start time being displayed indicating that communication between the tweak and the app is working as intended.
Enter the WiFi IP address of your Android phone running [WatchWitch Android](https://github.com/rec0de/watchwitch-android), then tap 'Set Target IP' to confirm.
With the Android app running, tap "Send Keys". A 'got keys!' message should appear on your Android phone. To better protect the transferred key material, you should set a custom transit secret in the app and enter the same secret on the Android side. Otherwise the app will fall back to a default secret which is strong, but technically public.
Enable the WiFi address override, and force an address update if you like. When losing Bluetooth connection, your watch will now connect to your Android phone instead of your iPhone.