# ts1/BLEUnlock

Lock/unlock your Mac with your iPhone, Apple Watch, or any other Bluetooth LE devices

Repository: https://github.com/ts1/BLEUnlock
Canonical: https://ross.abutalabs.com/products/bleunlock
Language: Swift
License Family: other
Topics: swift, macos, bluetooth-low-energy, ble, corebluetooth
Last push: 2024-07-12T21:27:10+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 2684, "days_push": 782, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4370, forks 293 (observed 2026-08-28T04:08:46.783596+00:00)

## What it is
BLEUnlock is a macOS menu bar utility that locks and unlocks your Mac based on the proximity of a Bluetooth Low Energy device such as an iPhone, Apple Watch, or any BLE device with a static MAC address. It stores your password securely in the Keychain and can optionally run scripts, wake the display, or pause media playback on lock/unlock.

## Use cases
- automatically unlock my Mac when my iPhone is nearby
- lock my Mac screen when I walk away with my Apple Watch
- use a BLE device as a proximity key for macOS
- pause music when I leave my desk and resume when I return
- run a custom script whenever my Mac locks or unlocks
- wake my Mac display from sleep when I approach

## When to choose
- you want password-free unlocking of a Mac using an iPhone, Apple Watch, or any BLE beacon
- you prefer a free, open-source alternative to commercial proximity-lock tools
- you want optional automation hooks (scripts, media pause, display wake) tied to lock/unlock events

## When to avoid
- you are not on macOS (it is Mac-only)
- your BLE device uses a rotating MAC address, which breaks detection
- you need a security-hardened, audited solution - proximity unlocking is inherently weaker than typing your password
- you require a signed Mac App Store distribution

## Facets
- artifact type: application
- maturity: active
- function: security, developer-tools
- domain: security, apple-ecosystem, developer-tools
- platform: -
- tags: bluetooth-low-energy, menu-bar-app, screen-lock, proximity-unlock, keychain, swift, macos

## Member repositories
- ts1/BLEUnlock (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:46.783596+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:21:23.029961+00:00, confidence not recorded.
  - readme: https://github.com/ts1/BLEUnlock (fetched 2026-08-28T04:08:46.783596+00:00, sha 34b02488b5a6)
- Data as of 2026-08-30T08:39:29.467469+00:00.