blueutil
v2.10.0
OSX上的蓝牙CLI：电源，可发现状态，列表，查询设备，连接，信息，…
Usage:
blueutil [options]
Without options outputs current state
-p, --power output power state as 1 or 0
-p, --power STATE set power state
-d, --discoverable output discoverable state as 1 or 0
-d, --discoverable STATE set discoverable state
--favourites, --favorites
list favourite devices; returns empty list starting with macOS 12/Monterey
--inquiry [T] inquiry devices in range, 10 seconds duration by default excluding time for name updates
--paired list paired devices
--recent [N] list recently used devices, 10 by default, 0 to list all; returns empty list starting with macOS 12/Monterey
--connected list connected devices
--info ID show information about device
--is-connected ID connected state of device as 1 or 0
--connect ID create a connection to device
--disconnect ID close the connection to device
--pair ID [PIN] pair with device, optional PIN of up to 16 characters will be used instead of interactive input if requested in specific pair mode
--unpair ID EXPERIMENTAL unpair the device
--add-favourite ID, --add-favorite ID
add to favourites; does nothing starting with macOS 12/Monterey
--remove-favourite ID, --remove-favorite ID
remove from favourites; does nothing starting with macOS 12/Monterey
--format FORMAT change output format of info and all listing commands
--wait-connect ID [TIMEOUT]
EXPERIMENTAL wait for device to connect
--wait-disconnect ID [TIMEOUT]
EXPERIMENTAL wait for device to disconnect
--wait-rssi ID OP VALUE [PERIOD [TIMEOUT]]
EXPERIMENTAL wait for device RSSI value which is 0 for golden range, -129 if it cannot be read (e.g. device is disconnected)
-h, --help this help
-v, --version show version
STATE can be one of: 1, on, 0, off, toggle
ID can be either address in form xxxxxxxxxxxx, xx-xx-xx-xx-xx-xx or xx:xx:xx:xx:xx:xx, or name of device to search in paired or recent devices
OP can be one of: >, >=, <, <=, =, !=; or equivalents: gt, ge, lt, le, eq, ne
PERIOD is in seconds, defaults to 1
TIMEOUT is in seconds, default value 0 doesn't add timeout
FORMAT can be one of:
default - human readable text output not intended for consumption by scripts
new-default - human readable comma separated key-value pairs (EXPERIMENTAL, THE BEHAVIOUR MAY CHANGE)
json - compact JSON
json-pretty - pretty printed JSON
Favourite devices and recent access date are not stored starting with macOS 12/Monterey, current time is returned for recent access date by framework instead.
Due to possible problems, blueutil will refuse to run as root user (see https://github.com/toy/blueutil/issues/41).
Use environment variable BLUEUTIL_ALLOW_ROOT=1 to override (sudo BLUEUTIL_ALLOW_ROOT=1 blueutil …).
Exit codes:
0 Success
1 General failure
64 Wrong usage like missing or unexpected arguments, wrong parameters
69 Bluetooth or interface not available
70 Internal error
71 System error like shortage of memory
75 Timeout error
使用软件包经理Homebrew：
# install
brew install blueutil
# update
brew update
brew upgrade blueutil
# uninstall
brew remove blueutil使用软件包MACPORTS：
# install
port install blueutil
# update
port selfupdate
port upgrade blueutil
# uninstall
port uninstall blueutil您可能需要将所有命令与sudo前缀。
git clone https://github.com/toy/blueutil.git
cd blueutil
# build
make
# install/update
git pull
make install
# uninstall
make uninstall您可能需要前缀安装/更新并卸载使用sudo命令。
使用Iobluetooth Framework（即IOBluetoothPreference*() ）的私有API。
如果蓝牙功率打开，或者在打开偏好窗格时打开蓝牙偏好窗格始终打开可发现性，则该状态的变化未由blueutil使用的函数报告。
构建和更新用法：
make build update_usage采用叮当式形式：
make format测试：
make test发布新版本：
./release major | minor | patch在GitHub上创建发布：
./verify_release如果没有验证错误，请复制生成的标记到新版本的描述：
open " https://github.com/toy/blueutil/releases/new?tag= $( git describe --tags --abbrev=0 ) " 最初由frederik seiffert [email protected] http://www.frederikseiffert.de/blueutil/
版权（C）2011-2024 Ivan Kuchin。有关详细信息，请参见License.txt。
