My ReefTank tools
Welcome to the documentation of my reef tank projects.
Home Assistant Integrations and Cards
Integrations
🐠 ha-reefbeat-component
Local Integration for Red Sea ReefBeat ecosystem.
Manage your Red Sea ReefBeat devices locally (no cloud required): ReefATO+, ReefDose, ReefLed, ReefMat, ReefRun and ReefWave.
⚠️ This is not an official Red Sea repository. Use at your own risk.
Key features:
- 100% local control — no cloud dependency for most devices
- Auto-detection of devices on local network (with manual mode and subnet support)
- Custom icons for all ReefBeat devices
- Firmware update notifications (with optional Cloud API)
- Live configuration update mode for real-time monitoring
- Multi-language support
Supported devices:
| Device | Models | Status |
|---|---|---|
| ReefATO+ | RSATO+ | ✅ Tested |
| ReefDose | RSDOSE2, RSDOSE4 | ✅ Tested |
| ReefLed | G1 (RSLED50/90/160), G2 (RSLED60/115/170) | ✅ Tested |
| ReefMat | RSMAT250, RSMAT500, RSMAT1200 | ✅ Tested |
| ReefRun | RSRUN | ✅ Tested |
| ReefWave | RSWAVE25, RSWAVE45 | ✅ / ☑️ |
| ReefControl | RSSENSE | ❌ Not yet — contact me |
ReefWave specifics: ReefWave is the only device tied to the ReefBeat cloud. Three operating modes are available — Cloud, Local, and Hybrid — so you can choose your balance between full local control and sync with the ReefBeat mobile app.
Installation: Available directly in HACS — search for “redsea” or “reefbeat”.
⚡ reefbeatEnergyBackup
Autonomous battery backup system for Red Sea reef aquariums.
Keep your ReefWave, ReefRun and DC Skimmer running during power outages with a 24V LiFePO₄ battery, a Raspberry Pi and smart pump degradation.
Key features:
- Battery monitoring via INA226 (I2C) + optional Victron BLE charger
- Instant outage detection via 230V relay on GPIO
- Progressive pump degradation — SoC-based levels computed from a target autonomy
- 3-level network failover — Ethernet → Wi-Fi → autonomous mirror hotspot
- 4G LTE failover — notifications and ReefBeat cloud access via USB modem or phone tethering
- Push notifications via ntfy.sh (free, no account required)
- Home Assistant integration — MQTT auto-discovery, update entity, battery test blueprint
- Self-update — checks GitHub for new versions, HA update entity with “Install” button
Hardware levels:
| Level | What you get | Budget |
|---|---|---|
| 1 — Basic | Battery + cables, passive backup | ~290 € |
| 2 — Normal (recommended) | + RPi + INA226 + relay, full monitoring & automation | ~402 € |
| 3 — Advanced | + Victron BLE charger, connected breaker, 4G modem | ~627 € |
Installation:
curl -sL https://raw.githubusercontent.com/Elwinmage/reefbeatEnergyBackup/main/install.sh | sudo bash
An interactive wizard configures everything: device scan, battery capacity, SoC levels, MQTT, notifications, 4G, scheduled reboot.
Works standalone or as a complement to ha-reefbeat-component for a fully integrated reef management setup.
🌊 ha-aquamedic-component
Control for Aqua Medic pumps via Home Assistant through the Gizwits cloud API.
Control your Aqua Medic pumps from Home Assistant via the Gizwits cloud API (same backend as the official Aqua Medic app).
Supported devices:
| Device | Status |
|---|---|
| EcoDrift / SmartDrift x.1 / x.3 (wavemaker) | ✅ Supported |
| DC Runner x.1 / x.2 / x.3 (return pump) | 🧪 Untested |
| Reefdoser EVO (dosing pump) | ❌ Not yet — contact me |
| T-Controller Twin (temperature controller) | ❌ Not yet — contact me |
| Aquarius / Spectrus (lighting) | ❌ Not yet — contact me |
EcoDrift / SmartDrift features:
- Power on/off, wave type (Pulse/Tide), feeding mode, timer, 0-10V control mode
- Wave modes: Classic, Sine, Random, Constant flow
- Linkage: Independent, Master, Slave
- Flow rate, frequency, and feeding duration controls
- Full diagnostic fault sensors (overcurrent, overvoltage, overtemperature, locked rotor, dry run, UART)
DC Runner features:
- Power on/off, feeding mode (10 min pause), 0-10V control mode
- Flow rate control (30–100%)
- Diagnostic fault sensors (dry run, locked rotor, voltage)
Installation: In HACS, add https://github.com/Elwinmage/ha-aquamedic-component as a custom repository (Integration), then search for “Aqua Medic”.
Cards
🪸 ha-reef-card
Custom Lovelace card for reef dashboards.
The Reef Card for Home Assistant helps you manage your reef aquarium directly from your dashboard. Combined with ha-reefbeat-component, it automatically detects and supports your Red Sea (ReefBeat) devices.
Non-Redsea devices can also be supported — request it here.
Supported devices:
| Device | Status | Highlights |
|---|---|---|
| ReefDose (RSDOSE2/4) | ✅ Implemented | Full scheduling, manual dosing, priming/calibration, supplement management, usage tracking |
| ReefMat (RSMAT250/500/1200) | ✅ Implemented | Animated roll status, manual/auto/scheduled advance, sensor status, weekly/monthly usage graphs |
| ReefRun (RSRUN) | ☑️ In progress | Pump speed control, overskimming management |
| ReefATO+ | ❌ Planned | Vote for priority |
| ReefLed (G1/G2) | ❌ Planned | Vote for priority |
| ReefWave | ❌ Planned | Vote for priority |
ReefDose highlights:
- 6-zone card: config/WiFi, states, manual dosing with shortcuts, head scheduling with circular progress, supplement management with brand images, and upcoming dose queue
- Supports priming and calibration workflows
- Supplement library with images for Red Sea, Tropic Marin, Quantum, ATI, Aqua Forest, and more
ReefMat highlights:
- 7-zone card with animated background that changes based on roll usage (0%–100%)
- Real-time roll info: remaining length, daily average, estimated days left
- Manual, automatic, and scheduled advance controls
- Level sensor status display (connected, disconnected, dirty)
- Weekly and monthly consumption graphs
Installation: Available directly in HACS — search for “reef-card”.
Configuration: Without the device parameter, the card automatically detects all ReefBeat devices and lets you choose. Set the device parameter to force a specific device.
 ReefDose demo |
 ReefMat demo |
📐 3D Models
ReefRun DC Skimmer
📦 Red Sea DC Skimmer impeller tool
💬 Contact & Support
- Questions & feature requests: Use the Discussions tab on each project
- Bug reports: Open an Issue with details
- Support the project:
