BLEUnlock

请注意，我不在 Mac App Store 上分发此应用程序。您可以在这里免费获取！

BLEUnlock 是一个小型菜单栏工具，可以通过 iPhone、Apple Watch 或任何其他蓝牙低功耗设备的接近程度来锁定和解锁您的 Mac。

本文档也有日语版本（日本語版はこちら）。

功能

• 无需 iPhone 应用程序
• 适用于任何定期从静态 MAC 地址发送信号的 BLE 设备
• 当 BLE 设备靠近您的 Mac 时，无需输入密码即可为您解锁 Mac
• 当 BLE 设备远离您的 Mac 时锁定您的 Mac
• 可选择在锁定/解锁时运行您自己的脚本
• 可选择从显示器睡眠状态唤醒
• 可选择在您离开和返回时暂停和恢复音乐/视频播放
• 密码安全存储在钥匙串中

要求

• 支持蓝牙低功耗的 Mac
• macOS 10.13 (High Sierra) 或更高版本
• iPhone 5s 或更新型号、Apple Watch（所有型号），或其他具有静态 MAC 地址并定期发送信号的 BLE 设备

安装

使用 Homebrew Cask

brew install bleunlock

手动安装

从 Releases 下载 zip 文件，解压并移动到应用程序文件夹。

设置

首次启动时，它会要求以下权限，您必须授予：

注意：随着 macOS 版本的每次更新，所需的权限数量都会增加，因此如果您使用的是较旧的操作系统，可能不会被要求一个或多个权限。

然后它会要求您输入登录密码以解锁锁定屏幕。 密码将安全地存储在钥匙串中。

最后，从菜单栏图标中选择设备。 它开始扫描附近的 BLE 设备。 选择您的设备，就完成了！

选项

故障排除

在列表中找不到我的设备

如果您的 BLE 设备不是来自 Apple，BLEUnlock 可能无法找到设备名称。 在这种情况下，您的设备会显示为 UUID（长的十六进制数字和连字符）。 要识别设备，请尝试将设备靠近或远离 Mac，看看 RSSI（dB 值）是否相应变化。

如果您在列表中看不到任何设备，请尝试按照下面的说明重置蓝牙模块。

无法解锁

确保在系统偏好设置 > 安全性与隐私 > 隐私 > 辅助功能中打开了 BLEUnlock。 如果已经打开，请尝试关闭然后重新打开。

如果它要求访问其自己在钥匙串中的密码的权限，您必须选择始终允许，因为在屏幕锁定时需要此权限。

频繁出现"信号丢失"

增加无信号超时。 或者尝试被动模式。

我的蓝牙键盘、鼠标、个人热点或其他蓝牙设备出现故障！

首先，按住 Shift + Option 键点击菜单栏或控制中心的蓝牙图标，然后点击"重置蓝牙模块"。

在 macOS 12 Monterey 中，此选项不再可用。 作为替代，在终端中输入以下命令来重置蓝牙模块：

sudo pkill bluetoothd

此命令将要求输入您的登录密码。

如果问题仍然存在，请开启"被动模式"。

MAC 地址说明

与经典蓝牙不同，蓝牙低功耗设备可以使用"私有" MAC 地址。 这个私有地址可以是随机的，并且可以不时更改。

最新的智能设备，包括 iOS 和 Android，倾向于使用每 15 分钟左右就会更改的私有地址。这可能是为了防止被追踪。

另一方面，为了让 BLEUnlock 能够追踪您的设备，其 MAC 地址必须是静态的。

幸运的是，在 Apple 设备上，如果您使用与 Mac 相同的 Apple ID 登录，MAC 地址会被解析为真实（公共）地址。

对于其他设备，包括 Android，解析地址的方法尚不清楚。 如果您的非 Apple 设备随时间变更其 MAC 地址，很遗憾 BLEUnlock 无法支持它。

要检查 MAC 地址是否正确解析，请比较 BLEUnlock 的"设备"扫描列表中显示的 MAC 地址与您设备上显示的地址。

在锁定/解锁时运行脚本

在锁定和解锁时，BLEUnlock 会运行位于以下位置的脚本：

~/Library/Application Scripts/jp.sone.BLEUnlock/event

根据事件类型，会传递不同的参数：

注意：为了使 intruded 事件正常工作，您需要在"安全性与隐私"偏好设置中设置"睡眠或屏幕保护程序开始立即要求输入密码"。

示例

以下是一个示例脚本，当 Mac 被手动解锁时，它会发送一条 LINE Notify 消息，并附带一张 Mac 前方人员的照片。

#!/bin/bash

set -eo pipefail

LINE_TOKEN=xxxxx

notify() {
    local message=$1
    local image=$2
    if [ "$image" ]; then
        img_arg="-F imageFile=@$image"
    else
        img_arg=""
    fi
    curl -X POST -H "Authorization: Bearer $LINE_TOKEN" -F "message=$message" \
        $img_arg https://notify-api.line.me/api/notify
}

capture() {
    open -Wa SnapshotUnlocker
    ls -t /tmp/unlock-*.jpg | head -1
}

case $1 in
    away)
        notify "$(hostname -s) 因 iPhone 远离而被 BLEUnlock 锁定。"
        ;;
    lost)
        notify "$(hostname -s) 因信号丢失而被 BLEUnlock 锁定。"
        ;;
    unlocked)
        #notify "$(hostname -s) 被 BLEUnlock 解锁。"
        ;;
    intruded)
        notify "$(hostname -s) 被手动解锁。" $(capture)
        ;;
esac

SnapshotUnlocker 是使用脚本编辑器创建的 .app，其脚本如下：

do shell script "/usr/local/bin/ffmpeg -f avfoundation -r 30 -i 0 -frames:v 1 -y /tmp/unlock-$(date +%Y%m%d_%H%M%S).jpg"

需要这个应用程序是因为 BLEUnlock 没有相机权限。 给予此应用权限可以解决这个问题。

资金支持

年度 Apple 开发者计划费用由捐赠资助。

如果您喜欢这个应用，我将非常感谢您能通过 Buy Me a Coffee 或 PayPal Me 进行捐赠，以便我能继续维护。

致谢

• peiit：中文翻译
• wenmin-wu：最小 RSSI 和移动平均
• stephengroat：CI
• joeyhoer：Homebrew Cask
• Skyearn：Big Sur 风格图标
• cyberclaus：德语、瑞典语、挪威语（书面语）和丹麦语本地化
• alonewolfx2：土耳其语本地化
• wernjie：唤醒而不解锁
• tokfrans03：语言修正

图标基于从 materialdesignicons.com 下载的 SVG。 它们最初由 Google LLC 设计，并根据 Apache License 2.0 版授权。

许可

MIT

版权所有 © 2019-2022 Takeshi Sone。