Skip to the content.
🌍 Language 🇺🇸 🇫🇷 🇩🇪 🇪🇸 🇮🇹 🇵🇱 🇵🇹

My ReefTank tools

Welcome to the documentation of my reef tank projects.


image 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.

Marketplace Badge GH-release GH-last-commit License: MIT

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:

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.

Marketplace Badge GH-release License: MIT

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:

DC Runner features:

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.

GH-release GH-last-commit License: MIT

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:

Installation: Search for “reef-maintenance” in Settings > Marketplace.


🐟 ha-reeftank-component

A living picture of your aquarium on the dashboard.

GH-release GH-last-commit License: MIT

ReefTank

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:

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.

GH-release GH-last-commit License: MIT TypeScript Lit

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:

ReefMat highlights:

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
ReefDose demo
ReefMat demo
ReefMat demo
ReefRun demo
ReefRun demo
Maintenance demo
Maintenance demo
ReefATO+ demo
ReefATO+ demo
ReefControl & ReefControl-Power demo
ReefControl & ReefControl-Power demo
ReefLed demo
ReefLed demo
ReefWave demo
ReefWave demo
Aqua Medic demo
Aqua Medic demo
Aquarium view demo
Aquarium view demo

🔌 Infrastructure


⚡ reefbeatEnergyBackup

Autonomous battery backup system for Red Sea reef aquariums.

GH-release GH-last-commit License: MIT

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:

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.

GH-release License: MIT

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