BLEUnlock
brew install --cask bleunlock
v1.12.2
Lock/unlock your Mac automatically based on proximity to a Bluetooth Low Energy device like an iPhone or Apple Watch.
Why you might care
Open-source and free alternative to paid proximity-lock apps. Works with any BLE device (iPhone, Apple Watch, etc.) without requiring a companion app. Stores credentials securely in Keychain and offers conveniences like auto-pausing media when you step away.
318
30-day installs · #664
779
90-day · #773
3.2k
365-day · #716
3.9k
★ GitHub stars · updated 1y ago
GitHub topics
ble
bluetooth-low-energy
corebluetooth
macos
swift
Links
- https://github.com/ts1/BLEUnlock
- GitHub: ts1/BLEUnlock
- Brew formula source: Casks/b/bleunlock.rb
Blurb generated by claude-haiku-4-5 on today.
Raw metadata
{
"alternatives": [
"Bluetooth Screen Lock",
"Proximity Lock"
],
"artifacts": [
{
"app": [
"BLEUnlock.app"
],
"target": "/Applications/BLEUnlock.app"
},
{
"zap": [
{
"trash": [
"~/Library/Application Scripts/jp.sone.BLEUnlock",
"~/Library/Caches/jp.sone.BLEUnlock",
"~/Library/Preferences/jp.sone.BLEUnlock.plist"
]
}
]
}
],
"auto_updates": null,
"categories": [
"security",
"menubar"
],
"deprecated": 0,
"deprecation_reason": null,
"desc": "Lock/unlock Apple computers using the proximity of a bluetooth low energy device",
"disable_reason": null,
"disabled": 0,
"display_name": "BLEUnlock",
"enrichment_fetched_at": "2026-06-20T22:41:05+00:00",
"first_seen": "2026-06-20T00:47:34+00:00",
"full_token": "bleunlock",
"github_default_branch": "master",
"github_last_commit_at": "2024-07-12T21:27:10Z",
"github_readme_excerpt": "# BLEUnlock\n\n## Please note that I don\u0027t distribute this app on the Mac App Store. You can find it here for free! \n\n\n\n[](https://www.buymeacoffee.com/tsone)\n\nBLEUnlock is a small menu bar utility that locks and unlocks your Mac by proximity of your iPhone, Apple Watch, or any other Bluetooth Low Energy device.\n\nThis document is also available in [Japanese (\u65e5\u672c\u8a9e\u7248\u306f\u3053\u3061\u3089)](README.ja.md).\n\n## Features\n\n- No iPhone app is required\n- Works with any BLE devices that periodically transmits signal from [static MAC address](#notes-on-mac-address)\n- Unlocks your Mac for you when the BLE device is near your Mac, without entering password\n- Locks your Mac when the BLE device is away from your Mac\n- Optionally runs your own script upon lock/unlock\n- Optionally wakes from display sleep\n- Optionally pauses and unpauses music/video playback when you\u0027re away and back\n- Password is securely stored in Keychain\n\n## Requirements\n\n- A Mac with Bluetooth Low Energy support\n- macOS 10.13 (High Sierra) or later\n- iPhone 5s or newer, Apple Watch (all), or another BLE device that has [static MAC address](#notes-on-mac-address) and transmits signal periodically\n\n## Installation\n\n### Using Homebrew Cask\n\n```\nbrew install bleunlock\n```\n\n### Manual installation\n\nDownload the zip file from [Releases](https://github.com/ts1/BLEUnlock/releases), unzip and move to the Applications folder.\n\n## Setting up\n\nOn the first launch, it asks for the following permissions, which you must grant:\n\nPermission | Description\n-----------|---\nBluetooth | Obviously, Bluetooth access is required. Choose *OK*.\nAccessibility | This is required to unlock the locked screen. Click *Open System Preferences*, click the lock icon on the bottom left to unlock, and turn on BLEUnlock.\nKeychain | (Not always asked) If asked, you have to choose **Alw",
"github_repo": "ts1/BLEUnlock",
"github_stars": 3944,
"github_topics": [
"ble",
"bluetooth-low-energy",
"corebluetooth",
"macos",
"swift"
],
"homepage": "https://github.com/ts1/BLEUnlock",
"homepage_og_description": null,
"homepage_og_image": null,
"homepage_title": null,
"installs_30d": 318,
"installs_365d": 3165,
"installs_90d": 779,
"last_seen": "2026-06-20T00:47:34+00:00",
"llm_generated_at": "2026-06-20T23:05:06+00:00",
"llm_model": "claude-haiku-4-5",
"names": [
"BLEUnlock"
],
"one_liner": "Lock/unlock your Mac automatically based on proximity to a Bluetooth Low Energy device like an iPhone or Apple Watch.",
"rank_30d": 664,
"rank_365d": 716,
"rank_90d": 773,
"raw_hash": "e9a0fc874e290db5",
"ruby_source_path": "Casks/b/bleunlock.rb",
"tap": "homebrew/cask",
"token": "bleunlock",
"version": "1.12.2",
"why_use_this": "Open-source and free alternative to paid proximity-lock apps. Works with any BLE device (iPhone, Apple Watch, etc.) without requiring a companion app. Stores credentials securely in Keychain and offers conveniences like auto-pausing media when you step away."
}