readme.adoc

blemacd

Blemacd is a macOS daemon to control BLE devices via Unix socket. This is a pet project mainly to control Philips Hue White Ambiance BLE bulb via Keyboard Maestro and/or Hammerspoon.

It is based on Apple’s CoreBluetooth library and its Rust wrapper.

Usage instructions

Open questions

• Better docs and HUE instructions

• Handle or limit multiple connections?

• Confirmation on command result (like status change)

• Populating list of devices may be done by different API calls:

  • CentralManager::get_peripherals/ retrievePeripheralsWithIdentifiers

  • CentralManager::get_peripherals_with_services, retrieveConnectedPeripheralsWithServices

  • CentralManager::scan scanForPeripheralsWithServices (CoreBluetooth docs)

• Looks like some peripherals can have multiple names?

Backlog

• Better status (include path, number of connections and uptime?)

• Better signals handling, namely Ctrl+C

• Options for commands (like format output)

• Homebrew formula

• Colorize output?

  • https://crates.io/crates/colored

  • https://docs.rs/termcolor

  • https://crates.io/crates/ansi_term

  • https://crates.io/crates/termion

• Show info:

  • UUID, RSSI in decibels

  • advertisement data: Service UUIDs, connectable, local_name

  • manufacturer data?

References

core_bluetooth API wrapper

• At crates.io

• At docs.rs with example

• Example code at Github

• CoreBluetooth docs at Apple.com

Bluetooth CLI tools

• BLE CLI for Windows

• Bluetooth (not BLE) CLI for OSX

Daemonizing

• How to daemonize at StackOverflow

Known problems

• Platform-specific imports are not resolved by Rust analyzer

Licensing

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)

• MIT License (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.