AquaBle is a Python-based Home Assistant custom component for controlling Chihiros aquarium devices over Bluetooth Low Energy (BLE). The focus is practical local control with clear workflows for everyday device management.
Status: Active development | License: GPLv3 | Stack: Python, Home Assistant, BLE
Highlights
Legal Disclaimer: This project is not affiliated with, endorsed by, or approved by Chihiros Aquatic Studio or Shanghai Ogino Biotechnology Co., Ltd. This is an independent, open-source software project developed through reverse engineering and community contributions. Use at your own risk.
Supported Device Types
- Chihiros LED Lights: Brightness and mode controls
- Chihiros Dosing Pumps: Scheduling and usage tracking
Requirements
- Home Assistant OS or Supervised installation
- Bluetooth adapter with BLE (Bluetooth Low Energy) support
- Compatible Chihiros device in pairing mode
- Python 3.10 or higher (included in Home Assistant)
Maintained by Caleb Venner. Built on the open-source Chihiros LED Control project by Michael Dietrich. The original project is licensed under MIT; all redistributions continue to honour that license and retain the upstream attribution.
Quick Start
For concise setup, add the AquaBle repository in Home Assistant and install via the standard custom component flow. Full steps, compatibility notes, and configuration details are maintained in the repository documentation.
- Add AquaBle repository in Home Assistant
- Install the integration and pair compatible BLE devices
- Configure dosing and lighting behavior from the dashboard
Detailed deployment and configuration notes are available in the AquaBle repository documentation.