Nearvale Help
Nearvale (formerly WatchLock) is a macOS menu-bar app. Walk away wearing your Apple Watch and the Mac locks; come back and the screen wakes. Unlocking is done by macOS's built-in "Unlock with Apple Watch".
1. First run
- Open the app. A menu-bar icon appears; follow the onboarding.
- Grant Bluetooth (required). The default lock method also needs Accessibility. To avoid that, choose "System interface (no permission)" or "Display off only" under Settings > General > Lock method.
- Pick and bind your Apple Watch in Settings > Device. Automatic locking does nothing until a watch is bound; the menu bar tells you so.
- Turn on "Unlock with Apple Watch" in macOS System Settings. Otherwise the screen only wakes and you type your password.
- (Recommended) Settings > Calibration > Distance calibration wizard: stay in your usual seat for 10 seconds to generate thresholds that fit your room.
2. Menu bar
| Icon state | Meaning |
|---|---|
| Near | Strong watch signal; stays unlocked |
| Away | Watch has been away for the configured time; locked or about to lock |
| Searching | Looking for the watch signal |
| Paused | You paused monitoring temporarily |
| Off | Monitoring is off |
The panel lets you lock now, pause, see the live signal, the signal zone it falls in (Near / Transition / Away) against the thresholds, and tap "Was that a false lock?" to report one.
3. Settings
- General: lock method, away duration, launch at login, notifications, and two optional exceptions (both off by default):
- Defer lock during meetings / presentations: when an app is preventing display sleep, locking is postponed and made up afterwards, with a hard upper limit.
- Re-arm after manual unlock: if you unlock with your password while the watch is still far, lock again after the keyboard and mouse have been idle for a while.
- Device: bind or unbind the watch; optionally pick up to 3 "auxiliary devices" (iPhone, AirPods, …): if the watch merely stops advertising while a device you chose is still nearby, locking is held off. Auxiliary devices only postpone locks caused by "signal lost" (for at most 2 minutes); they never lock the Mac by themselves and cannot override a clearly weak watch signal. An iPhone may stop advertising once its screen is off, so results depend on the device's state.
- The watch's Bluetooth address changes from time to time: once the old address has gone quiet and a same-named new address has kept showing up for about 6 seconds, the app re-links the binding automatically and notifies you. With the "Managed password entry (high risk)" unlock strategy it never re-links by itself; it notifies you to bind again manually (so a look-alike device cannot take over the binding).
- On a day you forgot the watch: when the signal source has been silent for about 3 minutes, the menu bar warns that automatic locking is not in effect and offers "Use …", which lets a chosen auxiliary device (such as your iPhone) stand in for the watch for up to 24 hours; tap "Use Watch Again" any time. Note: if the phone is left on the desk while you walk away, the Mac will not lock.
- Places: save the current network as a "trusted place" (home, office); auto-lock pauses while you are connected to it and resumes when you leave. The menu bar shows a notice, and Resume re-enables locking for the current stay. Network places are recognized by their gateway and need no permission; with Location Services allowed you can also "Trust current location" (radius 100 / 200 / 500 m), which keeps working when you switch networks at the same spot (for example a phone hotspot). A network or a location match counts as being at the place. If you are not on site, or the fix is off, click "Choose on Map…": click the map to place the center, the circle follows the radius, saved places show as gray circles, and you can also type "latitude, longitude". While the map is open, its imagery is requested from Apple Maps (the location you pick is stored on this Mac only). A Mac's positioning is only so accurate, so a poor or missing fix is never treated as being at a place; locations are compared on this Mac only and never uploaded. Other devices on the same network can spoof the fingerprint and a location can drift, so this is a convenience feature, not a security boundary.
- Calibration: the wizard; adjust the "near" and "away" thresholds. The "estimated distance" on that page is only a rough guide (indoors it can be off by several times); locking looks only at signal strength and the thresholds. If the automatic calibration at binding time finds the watch signal too weak to tell "near" from "away" reliably, it tells you and writes nothing.
- Diagnostics: false-lock stats and auto tuning (by trigger cause: a false lock from a weak signal adjusts the thresholds, one from interrupted advertising adjusts the "signal lost" timeout; after a long run without false locks it slowly returns toward the values you calibrated), lock history (time, reason and signal of every lock that ran; stored on this Mac, exportable as CSV), diagnostic log.
- License (release builds only): a 14-day free trial with every feature, then a one-time purchase for lifetime use. You get system notifications 3 days and 1 day before the end and when it ends (the "ended" notice ignores the notifications switch, because auto-lock has stopped by then). Once the trial is over, auto-lock, manual lock and settings are all disabled; only buying and entering a key remain. Before switching computers, click "Deactivate This Mac" to free up the activation slot. Builds you compile yourself have licensing off by default and have no such page.
- About: version, rerun onboarding, check for updates, open this manual.
4. FAQ
The watch is right next to the Mac but it locked. Why?
Look at the live signal in the menu bar. With the watch close it is about -42 dBm, and the default "away" threshold of -70 dBm is usually enough. If it still misfires, run the calibration wizard, or mark the lock as a false lock so the app relaxes things (the lock history shows whether each lock was triggered by a weak signal or by signal loss).
I walked away and nothing locked.
Check, in order: a watch is bound; Bluetooth is granted; with the Control-Command-Q lock method, Accessibility is granted (you get a notification if not); the meeting deferral is not on while some app is blocking display sleep; monitoring is not paused. The log under Settings > Diagnostics states why each lock did or did not happen.
It wakes the screen but does not unlock.
Unlocking is macOS, not this app. Make sure "Unlock with Apple Watch" is on in System Settings, and the watch is unlocked and on your wrist.
Do I have to re-authorize after updating?
The app is not Developer ID signed or notarized, so replacing it may make macOS ask again for Bluetooth or Accessibility. Tick them again when prompted.
What happens when the trial ends? (release builds only)
Auto-lock stops: your Mac will no longer lock when you walk away. The app says so clearly and sends a system notification. Your settings and lock history are kept, and everything resumes the moment you buy and enter a key. Once activated, the app checks online every 7 days; being offline is fine for 30 days, and only an explicit "invalid" answer from the server (for example, after a refund) turns it off.
Does it use the network?
Only in three cases. (1) When you click About > Check for Updates: one request to GitHub reads the latest version number; it carries no information about your Mac, and nothing is downloaded or installed automatically. (2) While the map window under Places > Choose on Map… is open: the map imagery for the visible area is requested from Apple Maps. The location you pick is never uploaded, and nothing is requested once the window is closed. (3) Only in release builds with licensing enabled: the trial never touches the network; the license key and a random device label (never your computer name) are sent to Dodo Payments only when you activate with a key, for the check every 7 days once activated, and when you click Deactivate. A failed check (for example, offline) never locks you out — there is a 30-day offline grace period.
5. Updating
Click "Check for Updates" in Settings > About. If a newer version exists, "Download" opens the GitHub Releases page. Download the DMG and drag the app into Applications to replace the old one. You can also download the latest version at any time from nearvale.app.
6. Reporting problems
Email support@nearvale.app or open an issue at GitHub Issues, and attach the log exported from Settings > Diagnostics (it is redacted). For license and refund questions, please use email and never post your license key in a public issue.