https://github.com/deeteeppg/bodega-bluetooth-le-hass
https://github.com/deeteeppg/bodega-bluetooth-le-hass
ble bluetooth bodega hacs home-assistant
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/deeteeppg/bodega-bluetooth-le-hass
- Owner: deeteeppg
- License: mit
- Created: 2026-01-15T15:20:21.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-01-18T04:27:24.000Z (5 months ago)
- Last Synced: 2026-01-19T11:44:33.401Z (5 months ago)
- Topics: ble, bluetooth, bodega, hacs, home-assistant
- Language: Python
- Size: 94.7 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Bodega Bluetooth LE for Home Assistant
Home Assistant custom integration for Bodega/Alpicool BLE fridges.
## Features
- Config flow discovery by BLE name prefix and service UUID
- BLE GATT query/notify parsing with coordinator
- Sensors, binary sensors, and a bind button
- Bluetooth Proxy compatible (HA Bluetooth stack)
## Installation
### HACS (Custom Repository)
1. In HACS, go to **Integrations** → **Custom repositories**.
2. Add this repository URL and select **Integration**.
3. Install **Bodega BLE Fridge**.
4. Restart Home Assistant.
5. Add the integration via **Settings → Devices & Services**.
### Manual
Copy `custom_components/bodega_ble` into your Home Assistant config `custom_components` directory
and restart Home Assistant.
## Bluetooth Proxy Support
This integration uses Home Assistant's Bluetooth stack for discovery and GATT connections,
which is compatible with ESPHome Bluetooth Proxy when the proxy can establish active
connections to the device.
## Development
Run unit tests:
```sh
pip install -r requirements-dev.txt
pytest
```
## Notes
- Service UUID: `00001234-0000-1000-8000-00805f9b34fb`
- Write characteristic UUID: `00001235-0000-1000-8000-00805f9b34fb`
- Notify characteristic UUID: `00001236-0000-1000-8000-00805f9b34fb`
## License
MIT. See `LICENSE`.
## RELEASE_NOTES
- Troubleshooting: Check HA logs for `bodega_ble`, confirm Bluetooth is enabled and the fridge advertises, and re-add the device if its BLE address changed.