Skip to content

v1.5.0

Choose a tag to compare

View all tags
@sytchi sytchi released this 21 Jul 21:32
v1.5.0
4886782

First public release of this fork of sjmotew/NarwalIntegration.

A fully local, cloud-free Home Assistant integration for Narwal robot vacuums (local WebSocket, port 9002). Fully supported and maintained on the Narwal Flow (AX12); other models are "probably working" (worked on upstream before this fork, not re-tested here).

Highlights over upstream

  • Clean modes: vacuum / mop / vacuum+mop / vacuum-then-mop (sequential)
  • Zone cleaning (narwal.clean_zone) and per-room cleaning (narwal.clean_rooms)
  • Station controls: wash mop, dry mop, empty dustbin, wake; mop-humidity select
  • Sensors: cleaning progress, dust-bag health, station activity, and a fault-code sensor with 48 codes translated to readable states (EN/FR/PL)
  • Live map: color-coded floor plan, dock marker, robot trail, active-zone overlay
  • narwal.resume to recover false "robot lifted" pauses
  • Firmware-compatibility fixes for v01.08.03+ (docked/paused detection)

See the README for setup and the CHANGELOG for full history.

Install via HACS -> Custom repositories -> https://github.com/sytchi/NarwalIntegration (Integration).

This is an unofficial, community integration, not affiliated with Narwal. Reverse-engineered for interoperability; use at your own risk.

Assets 2
Loading