Proximity Auto-Lock & Hands-Free Unlock for Windows 11 / 10 using Apple Watch via BLE
The seamless macOS Auto Unlock experience brought natively to Windows.
🌐 Languages / Idiomas:
English (Main) |
Español |
Français |
Português |
Deutsch |
Italiano |
简体中文 |
한국어 |
日本語
Windows includes a feature named Dynamic Lock, but it falls short for daily productivity. WristKey overcomes these limitations by implementing genuine proximity tracking through Apple Continuity protocol analysis:
| Feature | Windows Dynamic Lock | WristKey |
|---|---|---|
| Walk-Away Auto-Lock | ❌ Slow (waits up to 1-2 minutes) | ✅ Instant & Configurable (asymmetric RSSI filter) |
| Approach Auto-Unlock | ❌ Not supported (lock only) | ✅ Hands-Free Automatic Unlock (Credential Provider) |
| On-Wrist Optical Check | ❌ None (remains active on desk/charger) | ✅ Continuity 0x004C Verified (revokes access when taken off) |
| Battery Consumption | ❌ High (continuous classic Bluetooth polling) | ✅ Ultra-Low Power (passive BLE advertisements) |
| Address Privacy (RPA) | ❌ Fails when BLE MAC rotates | ✅ Hardware AES-128 IRK Resolution (ah(IRK, prand)) |
| Credential Security | N/A | ✅ Encrypted via Windows DPAPI (never in plaintext) |
Similar to the native Auto Unlock feature in macOS and watch-unlock-rs in Linux, WristKey continuously monitors your Apple Watch in the background via Bluetooth Low Energy (BLE):
- 🔒 Automatically locks your PC whenever you step away from your desk.
- 🔓 Wakes the display and logs you back in the moment you sit down.
- 🛑 Optical On-Wrist Security: If you take off the watch or lock it with a passcode, access is immediately revoked.
Download the official standalone installer from the GitHub Releases page:
Run the .exe installer. It includes language selection during setup (English, Spanish, French, Portuguese, German, Italian, Chinese, Korean, Japanese) and allows switching languages at any time directly within the application.
When running the installer for the first time on Windows 11 or 10, Microsoft Defender SmartScreen may display a blue warning screen ("Windows protected your PC"):
- Cloud Telemetry Reputation: SmartScreen is Microsoft's telemetry-based reputation system. Each newly compiled release (
v0.5.0, etc.) produces a fresh binary with a unique cryptographic hash that hasn't accumulated tens of thousands of downloads in Microsoft's telemetry database yet. - Cost of EV Code Signing Certificates: To suppress warnings on newly compiled desktop apps, Microsoft requires developers to buy an Extended Validation (EV) Code Signing Certificate, which costs $300 to $500 per year through enterprise certificate authorities (DigiCert, Sectigo). For independent, community-driven open-source projects, this cost is prohibitive.
- 100% Verifiable Security & Privacy:
- WristKey is 100% Open Source.
- You can inspect every line of Rust code directly in this repository.
- User credentials are encrypted locally on your machine via Windows DPAPI (
CryptProtectData) tied to your Windows user account master key. - Zero third-party telemetry, tracking, or external network requests.
- On the initial SmartScreen dialog, click the underlined link: "More info" ("Más información").
- The "Run anyway" ("Ejecutar de todas formas") button will appear in the bottom-left corner; click it to proceed.
- RPA Resolution (AES-128 IRK):
Apple devices rotate their Bluetooth MAC address every ~15 minutes (Resolvable Private Address). WristKey resolves RPAs against the paired watch's Identity Resolving Key (IRK) using hardware AES-128 (
ah(IRK, prand)per Bluetooth SIG Core Spec). - Apple Continuity Telemetry (0x004C):
Parses Apple Continuity frames (
type 0x10 Nearby Info). If you take off the watch or lock it, watchOS asserts the lock flag; WristKey denies access until re-authenticated on wrist. - DPAPI Credential Encryption:
Login credentials used for automatic unlock are stored using Windows DPAPI (
CryptProtectData), encrypted with your user account master key. Plaintext passwords are not stored on disk. - Named Pipe IPC:
Authentication between the daemon and the Windows Credential Provider communicates over a restricted local Named Pipe (
\\.\pipe\WristKeyUnlockPipe).
Apple Watch (BLE Advertisement)
│ (RPA rotated every 15 min + Apple Continuity telemetry)
▼
Windows BLE Watcher (WinRT)
▼
RPA Resolver (AES-128 IRK matching via Bluetooth Core Spec)
▼
Apple Continuity Parser (0x004C / 0x10 Nearby Info)
│ Verifies watch is on wrist and unlocked (Action Code 0x0A / 0x0B)
▼
RSSI Asymmetric EMA Filter & Hysteresis State Machine
├── Walk Away (RSSI < -80 dBm or Off-Wrist) ──> LockWorkStation()
└── Approach (RSSI > -58 dBm and On-Wrist) ──> Wake Screen & Unlock via Credential Provider
The repository includes a command-line tool (wristkey-cli) for diagnostics, signal calibration, packet inspection, and headless background execution.
Prerequisites:
- Windows 11 or Windows 10 (version 1903+)
- Bluetooth 4.2+ adapter with LE support
- Rust (edition 2021+)
# Clone the repository
git clone https://github.com/jorjanion/WristKey.git
cd WristKey
# Run unit and cryptographic tests
cargo testScans for nearby BLE advertisements and decodes Apple Continuity payloads (0x004C), showing RSSI, frame types, and raw bytes:
cargo run -p wristkey-cli -- --scanDisplays a live visual RSSI signal meter and estimated distance in meters:
cargo run -p wristkey-cli -- --calibrateQueries HKLM\SYSTEM\CurrentControlSet\Services\BTHPORT\Parameters\Keys to dump paired Bluetooth LE Identity Resolving Keys (requires Administrator terminal):
cargo run -p wristkey-cli -- --list-keysValidates the local ah(IRK, prand) AES-128 implementation against the official Bluetooth SIG Core Specification test vectors:
cargo run -p wristkey-cli -- --verify-cryptoReal-time decoding of Nearby Info flags (on-wrist state, user activity, auto-unlock eligibility, Wi-Fi status, and auth tags):
cargo run -p wristkey-cli -- --telemetryWe welcome contributions from the community! Check out our CONTRIBUTING.md guide to get started with bug reports, feature requests, and Pull Requests.
- Bluetooth Adapter Not Recognized: Ensure your PC's Bluetooth adapter supports Bluetooth Low Energy (BLE 4.2 or higher).
- Wrist Detection Disabled on Watch: In the Apple Watch app on your iPhone, go to Passcode and ensure Wrist Detection is toggled ON.
- Display Does Not Wake: Ensure Windows Power & Sleep settings allow peripheral wake events.
Licensed under either of:
- Apache License, Version 2.0 (LICENSE-APACHE)
- MIT License (LICENSE-MIT)
at your option.



