blueutil - macOS 蓝牙命令行管理工具

应用简介

blueutil 是一个强大而轻量级的 macOS 命令行工具，专门用于管理和控制系统的蓝牙功能。通过简单的终端命令，用户可以轻松地执行各种蓝牙操作，无需打开繁琐的系统偏好设置界面。

核心功能

1. 蓝牙电源管理

• 查询当前蓝牙模块的开关状态
• 一键开启或关闭蓝牙电源
• 输出简洁的状态码（1=开启，0=关闭）

2. 可见性控制

• 检查蓝牙设备是否处于可被发现状态
• 动态切换可被发现状态
• 与电源状态同步管理

3. 设备管理

• 列出已配对设备：快速查看所有已配对的蓝牙设备
• 扫描附近设备：搜索范围内的可用蓝牙设备（默认10秒）
• 显示最近使用设备：查看最近连接过的蓝牙设备记录
• 筛选已连接设备：仅显示当前处于连接状态的设备
• 收藏设备列表：查看标记为收藏的设备（注：macOS 12/Monterey及以上版本返回空列表）

4. 设备连接与控制

• 获取特定设备的详细信息
• 检查设备的连接状态
• 手动发起设备连接请求
• 支持设备ID或地址进行精确操作

技术特色

双模式设备查询

# 默认使用IOBluetooth框架API
blueutil --paired

# 使用system_profiler替代方案（适用于多连接点设备）
BLUEUTIL_USE_SYSTEM_PROFILER=1 blueutil --paired

多设备连接优化：针对可同时连接多个设备的多连接点蓝牙设备，blueutil提供了system_profiler模式，解决某些设备通过IOBluetooth API无法正确报告连接状态的问题。

灵活的查询参数

• 可自定义设备扫描时长
• 支持设置最近使用设备的显示数量
• 可列出所有历史设备或限定数量

优势特点

🚀 快捷高效

• 无需图形界面，通过终端快速执行
• 适合自动化脚本和远程管理
• 响应迅速，几乎无延迟

🔧 自动化友好

• 所有操作都可集成到脚本中
• 可作为其他应用的依赖工具
• 支持批量操作和设备管理

📊 状态清晰

• 输出简洁明了的数字状态码
• 支持JSON等结构化输出格式
• 易于程序解析和处理

🔄 兼容性强

• 支持多种macOS版本
• 针对新版系统做了适配调整
• 提供替代方案解决兼容性问题

使用场景

开发调试

• 蓝牙应用开发时的状态监控
• 自动化测试脚本中的蓝牙控制
• 设备连接状态的实时检查

系统管理

• 远程服务器蓝牙管理
• 批量设备配置和维护
• 电源管理优化脚本

日常工作

• 快速开关蓝牙节省电量
• 一键连接常用设备
• 设备状态快速检查

注意事项

• API限制：使用IOBluetooth框架的私有API，某些功能可能随系统更新而变化
• 系统兼容：--favourites和--recent命令在macOS 12/Monterey及以上版本返回空列表
• 实验功能：system_profiler模式为实验性功能，可能与部分命令不兼容

安装方式

通过Homebrew一键安装：

brew install blueutil

或从GitHub仓库直接下载编译：

cd blueutil
make
sudo make install

blueutil以其简洁的接口和强大的功能，成为macOS开发者和管理员在蓝牙管理方面的得力工具，特别适合那些偏好命令行操作或需要自动化蓝牙工作流的用户。