Volcano Hybrid — Homebridge Plugin

Homebridge plugin for the Storz & Bickel Volcano Hybrid vaporizer. Brings the device into Apple HomeKit so you can control temperature, heating, and airflow from the Home app, Siri, or automations.

macOS only. Connects directly via CoreBluetooth — no separate hub or server required.

HomeKit controls

| Tile | Function | |---|---| | Thermostat | Live temperature on the arc; set target temperature (40–230°C) | | Heat switch | Turn the heating element on/off | | Pump switch | Turn the air pump on/off |

Requirements

• macOS
• Homebridge ^1.8.0 || ^2.0.0

Installation

Search for Volcano Hybrid in the Homebridge Config UI X plugin browser and click Install.

Bluetooth permission

macOS requires explicit Bluetooth permission for Homebridge. Do this once after installing:

1. Open System Settings → Privacy & Security → Bluetooth
2. Click +, press Cmd+Shift+G, paste your Node.js binary path (which node), and enable the toggle
3. Restart Homebridge

If you use nvm, the path includes the version number (e.g. /Users/you/.nvm/versions/node/v24.x.x/bin/node) — you'll need to re-add it after a Node.js upgrade.

Configuration

Add to your Homebridge config.json:

{
  "platforms": [
    {
      "platform": "VolcanoHybrid",
      "name": "Volcano Hybrid",
      "devices": [
        {
          "name": "Volcano",
          "address": "AA:BB:CC:DD:EE:FF",
          "bleAdvertisementName": "VOLCANO H"
        }
      ]
    }
  ]
}

| Field | Required | Default | Description | |---|---|---|---| | name | yes | — | Accessory name in the Home app | | address | yes | — | Unique identifier for Homebridge's accessory cache. Not used for Bluetooth discovery — any string works. | | bleAdvertisementName | no | "VOLCANO H" | BLE advertisement name used to find the device. The default works for most units. |

To find your device's advertisement name, run system_profiler SPBluetoothDataType with the Volcano powered on.

Troubleshooting

Scan timeout — device not found

The Volcano supports one Bluetooth connection at a time. Disconnect from the Storz & Bickel app first, then ensure the device is powered on and in range.

Keeps reconnecting

Another app is holding the connection. Quit the Storz & Bickel app and toggle Bluetooth off and on in System Settings.

BT state: unauthorized in logs

Bluetooth permission hasn't been granted — follow the Bluetooth permission steps above. If you recently upgraded Node.js via nvm the binary path changed; re-add it.

Controls show an error in the Home app

HomeKit polled before the BLE connection was ready. Wait for BLE ready in hb-service logs then try again.

License

MIT © Rosh Beed