aziz66/homebridge-xbloom

homebridge-xbloom is a plugin for Homebridge, the server that connects smart home devices to Apple HomeKit, that lets you brew saved coffee recipes on an xBloom coffee machine using Siri or the Home app, talking to the machine directly over Bluetooth. Each recipe you set up becomes its own HomeKit switch, so saying a phrase like turn on Ethiopia can start that specific brew, and the switch can also be triggered from any HomeKit automation such as an alarm or a presence trigger. This is an unofficial project, not affiliated with or supported by xBloom, built from a clean room understanding of the machine's Bluetooth protocol rather than any official documentation, and it works entirely locally with no cloud connection. The plugin connects to the machine only while a brew is happening and releases the connection afterward, so the official xBloom phone app can still connect normally between brews. Recipes are defined directly in the Homebridge configuration screen, including dose, grind size, ratio, and a full pour profile covering water volume, temperature, flow rate, and pauses for each pour step, so no companion app or manual capture is needed. The plugin also exposes a brewing status sensor that shows faults such as no beans, an empty water tank, or an incorrect dose, plus optional switches to stop a brew early or manually hold and release the Bluetooth connection. It requires Homebridge version 1.8 or newer running on Node.js 22 or 24, on a Linux host running the BlueZ Bluetooth stack, since macOS and Windows Homebridge hosts are not supported for this Bluetooth link. An xBloom machine must be physically loaded with a pod or grounds and water before a brew can start, since the plugin can only trigger the brewing program rather than load ingredients itself. Extra setup steps are documented for permissions when Homebridge runs as a non root user and for running Homebridge inside Docker, where the container needs access to the host's Bluetooth service. The project is MIT licensed.