My ReefTank tools
Welcome to the documentation of my reef tank projects.
- My ReefTank tools
Home Assistant Integrations and Cards
Since Home Assistant 2026.11, HACS is part of Home Assistant as the Marketplace (Settings > Marketplace). On an older Home Assistant, the same steps work in HACS.
Integrations
🐠 ha-reefbeat-component
Local Integration for Red Sea ReefBeat ecosystem.
Manage your Red Sea ReefBeat devices locally (no cloud required): ReefATO+, ReefControl, ReefControl-Power, 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
- Dose regulation for the ReefDose: assisted dosing from your test results, brine regulated on the salinity
- Poseidon mode (experimental): a local relay that replaces most of the polling by what the devices push, with the history of the doses and the alarms of the devices as Home Assistant events
- Multi-language support
Supported devices:
✅ Supported 🚧 In progress 🧪 Untested (may work) ❌ Not yet supported
| Device | Models | Status |
|---|---|---|
| ReefATO+ | RSATO+ | ✅ |
| ReefControl | RSCONTROLPRO | ✅ |
| ReefControl | RSCONTROLLITE | 🧪 |
| ReefControl-Power | RSPOWER6 | ✅ |
| ReefControl-Power | RSPOWER8 | 🧪 |
| ReefDose | RSDOSE2, RSDOSE4 | ✅ |
| ReefLed | G1 (RSLED50/90/160), G2 (RSLED60/115) | ✅ |
| ReefLed | G2 (RSLED170) | 🧪 |
| ReefMat | RSMAT250, RSMAT500, RSMAT1200 | ✅ |
| ReefRun | RSRUN | ✅ |
| ReefWave | RSWAVE25, RSWAVE45 | ✅ |
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 the Marketplace — search for “redsea” or “reefbeat”.
🌊 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:
✅ Supported 🚧 In progress 🧪 Untested (may work) ❌ Not yet supported
| Device | Status |
|---|---|
| EcoDrift / SmartDrift x.1 / x.3 (wavemaker) | ✅ |
| DC Runner x.1 / x.2 / x.3 (return pump) | ✅ |
| DC Runner (skimmer pump) | ✅ |
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
- Time-slot program, up to 48 slots
- Full diagnostic fault sensors (overcurrent, overvoltage, overtemperature, locked rotor, dry run, UART)
DC Runner features:
- Power on/off, feeding mode (1–60 min pause), 0-10V control mode
- Flow rate control (30–100%)
- Time-slot program, up to 48 slots
- Diagnostic fault sensors (dry run, locked rotor, voltage, overcurrent, overtemperature, UART)
Installation: Search for “Aqua Medic” in Settings > Marketplace.
🐟 ha-vson-component
VSON automatic fish feeders in Home Assistant through the VSON cloud API. The WP8621 feeder can also run fully local by reflashing it with ESPHome — same board, no cloud.
Supported devices:
✅ Supported 🚧 In progress 🧪 Untested (may work) ❌ Not yet supported
| Device | Models | Status |
|---|---|---|
| WP8621 automatic fish feeder | variants N/E/H/F/B/P/A/C | ✅ |
| Any other VSON device | detected | 🧪 |
🐙 ha-reef-maintenance-component
Maintenance tracking for equipment Home Assistant cannot reach.
Flow pumps, return pumps, skimmers, media reactors — anything you service by hand. One config entry per brand, one device per piece of equipment, four entities per task: a button that records the job, a number for the interval, a switch to mute alerts and a date to backdate the last intervention.
Key features:
- Presets for Tunze, Jebao and generic gear, with manufacturer intervals where one is published
- A shared library of 22 tasks, translated in 8 languages
- Backdating, so a new piece of equipment does not start from “never done”
reef_maintenance.resetservice — stick an NFC tag on the pump and scan it when you are done- Same
reef_rolecontract as the connected integrations, so tasks land in the card’s maintenance view
Installation: Search for “reef-maintenance” in Settings > Marketplace.
🐟 ha-reeftank-component
A living picture of your aquarium on the dashboard.

The integration behind the aquarium card of ha-reef-card: your photo, the water lit by your real lamps, animated fish and corals, and your devices and entities on it. It stores the aquariums, their pictures and their livestock, and records the feedings.
Key features:
- Outline the water, the sand and the rocks on your own photo — or draw the tank with rock and sand textures
- Fish that shoal, cruise, crawl on the sand or peek out of their burrow, and hide behind the rocks at night
- Water tinted by your lamps (ReefLED or any light), corals swaying with the pumps
- Feedings recorded from feeders, shortcuts or a service; fish and coral counts as sensors; pH and ORP watched against the tank’s own history
- Species from the reeftank-catalog, kept up to date automatically
Installation: Search for “ReefTank” in Settings > Marketplace, and install ha-reef-card for the card.
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:
✅ Supported 🚧 In progress 🧪 Untested (may work) ❌ Not yet supported
| Device | Status | Highlights |
|---|---|---|
| ReefDose (RSDOSE2/4) | ✅ | Full scheduling, manual dosing, priming and calibration, supplement management, usage tracking, dose regulation (assisted dosing, brine), dose history |
| ReefMat (RSMAT250/500/1200) | ✅ | Animated roll status, manual/auto/scheduled advance, sensor status, weekly and monthly graphs |
| ReefRun (RSRUN) | ✅ | Pump speed control, schedule editor, overskimming management |
| ReefATO+ | ✅ | Water level, leak probe, pump diagnostics, consumption graph, leak buzzer |
| ReefControl (RSCONTROLPRO) | ✅ | Probes with level bars, trends and 7-day history, guided pH/EC/ORP/temperature calibration, 12V ports, ATO, buzzer, paired power center |
| ReefControl (RSCONTROLLITE) | 🧪 | Probes with level bars, trends and 7-day history, guided pH/EC/ORP/temperature calibration, 12V ports, ATO, buzzer, paired power center |
| ReefControl-Power (RSPOWER6) | ✅ | Per-socket control, on/off/schedule/probe modes, linked devices, local temperature probe or ReefControl link |
| ReefControl-Power (RSPOWER8) | 🧪 | Per-socket control, on/off/schedule/probe modes, linked devices, local temperature probe or ReefControl link |
| ReefLed (G1) | ✅ | Sky with sun and moon, beam with the day’s program, intensity/colour or white/blue sliders, program editor (kelvin or white/blue, clouds), weather mode, groups with staggered sunrise, acclimation |
| ReefLed (G2) | 🧪 | Sky with sun and moon, beam with the day’s program, intensity/colour or white/blue sliders, program editor (kelvin or white/blue, clouds), weather mode, groups with staggered sunrise, acclimation |
| ReefWave (RSWAVE25/45) | ✅ | Animated pump view, speed and direction, wave library, schedule editor with time slots, pump groups |
| Aqua Medic EcoDrift / SmartDrift | ✅ | Pump speed on the picture, faults, feed pause, time-slot program editor |
| Aqua Medic DC Runner (return, skimmer) | ✅ | Return or skimmer pump view following the integration’s role, speed, faults, time-slot program editor |
| Energy Backup (reefbeatEnergyBackup) | ✅ | Power flows of the mains, the battery and the pumps, drawn with Power Flow Card Plus |
| VSON fish feeder (hacked, ESPHome) | ✅ | Live picture of the feeder, feeding slots, reserve warning, feed now |
| Aquarium view (ha-reeftank-component) | ✅ | Your tank photo with live devices and entities, water tinted by your lamps, animated fish and corals, seven-tab scene editor |
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
- Dose regulation dialogs: assisted dosing, brine with its salinity chart
- 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
Aquarium view: a second card, custom:reef-aquarium-card, shows a living picture of your tank. It needs ha-reeftank-component.
Installation: Available directly in the Marketplace — 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 |
![]() ReefRun demo |
![]() Maintenance demo |
![]() ReefATO+ demo |
![]() ReefControl & ReefControl-Power demo |
![]() ReefLed demo |
![]() ReefWave demo |
![]() Aqua Medic demo |
![]() Aquarium view demo |
🔌 Infrastructure
⚡ 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
- Poseidon mode watchdog — watches the MQTT relay of ha-reefbeat-component and switches the devices back to normal mode when it dies
- 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 | ~664 € |
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-reef-blueprints
Automation blueprints for the whole ecosystem.
Alerts you on your phone about overdue maintenance, found through the shared reef_role attribute so every integration is covered, and about devices that went unreachable. Tests your heaters one at a time, and warns you when a relay reads off while its appliance still draws power. Eight languages, one import button each.
Installation: import from the repository, one button per language.
📐 3D Models
ReefRun DC Skimmer
📦 Red Sea DC Skimmer impeller tool
Video demonstration:
📦 RedSea DC Skimmer foots
Risers for the feet of the Red Sea DC skimmer, to set its height in the sump. Four versions: 80, 70, 60 and 50 mm.
Water tests
📦 Organizer for Red Sea reef aquarium tests
A storage system for the Red Sea reef water test kits.
💬 Contact & Support
- Questions and feature requests: open a discussion on the project concerned — ha-reefbeat-component · ha-aquamedic-component · ha-reef-card · ha-reef-maintenance-component · ha-reeftank-component · reeftank-catalog · reefbeatEnergyBackup · ha-reef-blueprints
- Bug reports: open an issue on that same project, with the details.
- Support the project:









