Before you remove it, most reasons are a setting
People usually reach for the uninstall step for one of two reasons, and both are settings rather than faults. If Peeku locks the screen while you are still reading or on a call, that is the inactivity behaviour and the presence timing, both adjustable. If it does not seem to lock at all, that is almost always the macOS "Require password" setting rather than Peeku. It is worth a look before you delete anything. If you have decided to remove Peeku anyway, the rest of this guide is the complete, clean removal.
Step 1: Quit Peeku
Peeku runs as a menu bar app with no Dock icon. Click the Peeku icon in the menu bar at the top of the screen and choose Quit. If you had turned on "Start at login", you can also open System Settings, go to General and then Login Items, and switch Peeku off under "Open at Login" first, though this is handled for you automatically in the next step.
Step 2: Remove the app
Open the Applications folder in Finder, find Peeku, and drag it to the Trash, or select it and press Command and Delete. That is the whole app.
There is no separate background item to hunt down. Peeku registers its launch-at-login option through the built-in macOS Service Management framework, which ties the login item to the app itself, so deleting the app removes that registration too. The build you download runs as a single menu bar app; it does not install a hand-placed login-item file or a separate system daemon that you would need to remove by hand.
Step 3: Delete the files Peeku created
Peeku keeps its settings and its optional local data in your own Library and config folders. Removing the app does not delete these, so remove them yourself for a complete uninstall. There are three locations:
~/.config/proximity-lock/holdsconfig.json, your Peeku settings, and, only if you enrolled a known face,known-face-enrollment.json, the local face feature prints described in the guide on how Mac face detection works. Deleting the folder removes both.~/Library/Logs/peeku-lock-events.logis the diagnostic log of when and why Peeku locked. It exists only if auto-lock has run.~/Library/Preferences/app.peeku.Peeku.plistholds a small set of app preferences.~/Library/Group Containers/AVGA7YK5X2.app.peeku.Peeku/is a small shared status cache that lets the menu bar and the optional Mac widget read the current lock state. It holds no camera images and no face data. It may not be present on every setup, so remove it only if it is there.
Remove them in Finder
- In Finder, from the menu bar choose Go and then "Go to Folder".
- Paste
~/.config/proximity-lockand press Return, then drag the folder to the Trash. - Repeat with
~/Library/Logsand removepeeku-lock-events.log, then with~/Library/Preferencesand removeapp.peeku.Peeku.plist. - Finally, go to
~/Library/Group Containersand remove theAVGA7YK5X2.app.peeku.Peekufolder if it is present.
Or remove them in the Terminal
After quitting Peeku, these user-scoped commands do the same thing and need no administrator password:
rm -rf ~/.config/proximity-lockrm -f ~/Library/Logs/peeku-lock-events.logdefaults delete app.peeku.Peekurm -rf ~/Library/Group\ Containers/AVGA7YK5X2.app.peeku.Peeku
Why defaults delete rather than removing the plist directly: macOS caches preferences in memory, so deleting the file by hand can be rewritten from the cache. The defaults delete command clears the cached copy as well.
Step 4: Review the permissions you granted
When you first ran Peeku, macOS asked you to allow camera and Bluetooth access, and optionally notifications. macOS keeps these grants listed even after an app is deleted, so tidy them up if you want no trace left. Open System Settings and go to Privacy & Security, then check Camera and Bluetooth and switch Peeku off or remove it from each list. You can do the same under Notifications. The guide on Mac camera privacy walks through where these controls live and how to read them.
What Peeku does not leave behind
Because Peeku is built to keep everything on your Mac, an uninstall is genuinely local. There is no Peeku account to delete, because Peeku never asked you to make one. Nothing you did was uploaded to a Peeku server: no camera images, no face data, and no log of when you were at your desk, so there is no cloud copy to request removal of. Once the app and the files above are gone, and the permissions are cleared, the removal is complete. This is the same on-device principle described in the guide on privacy-first, on-device auto-lock: what stays on your Mac is what you can delete yourself.
Changed your mind, or want to try it again later?
Peeku is free, needs no account, and keeps all detection on your Mac. If you decide to reinstall down the line, it is a small download and a two-minute setup.
macOS 14+, Apple Silicon. About 3.1 MB. Developer ID signed and notarised. Pay what you want on Gumroad (₹0 option available).
Free Mac App Store build
Prefer the App Store path?
Install Peeku Presence Coach for eye-rest nudges, walk reminders, optional Desk Health, and private local presence signals. The full walk-away lock still needs the direct Mac build because the App Store sandbox blocks automatic screen-lock commands.