Skip to content

timniklas/hass-neakasa

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 

Repository files navigation

Neakasa Integration for Home Assistant 🏠

GitHub Release GitHub Release Date GitHub Downloads (all assets, latest release) HA Analytics GitHub commit activity hacs

Overview

The Neakasa Home Assistant Custom Integration allows you to integrate your Neakasa devices with your Home Assistant setup.

Currently supported devices

  • Neakasa M1

Currently supported features

Sensors:

Sensor Unit Example Value Enabled by default
Cat litter level percent 80 % yes
WiFi RSS dB -60 dB no (debug information)
Last stay time seconds 45 s no
Last usage datetime 2024-12-07 14:52 yes
Device status idle / cleaning/ leveling idle yes
Cat litter state insufficient / moderate / sufficient sufficient yes
Bin state normal / full / missing normal yes

Binary sensors:

Binary Sensor Example Value Enabled by default
Garbage can full off yes

Buttons:

Button Action Enabled by default
Clean Cleans the litter box yes
Level Initiates the leveling process yes

Switches:

Switch Enabled by default
Kitten mode no (rare edgecase)
Child lock yes
Automatic cover yes
Automatic leveling yes
Silent mode yes
Automatic recovery no (potentialy dangerous!)
Unstoppable cycle yes

Installation

HACS (recommended)

This integration is available in HACS (Home Assistant Community Store).

  1. Install HACS if you don't have it already
  2. Open HACS in Home Assistant
  3. Go to any of the sections (integrations, frontend, automation).
  4. Click on the 3 dots in the top right corner.
  5. Select "Custom repositories"
  6. Add following URL to the repository https://github.com/timniklas/hass-neakasa.
  7. Select Integration as category.
  8. Click the "ADD" button
  9. Search for "Neakasa"
  10. Click the "Download" button

Manual

To install this integration manually you have to download neakasa.zip and extract its contents to config/custom_components/neakasa directory:

mkdir -p custom_components/neakasa
cd custom_components/neakasa
wget https://github.com/timniklas/hacs_blitzerde/releases/latest/download/neakasa.zip
unzip neakasa.zip
rm neakasa.zip

Configuration

Using UI

Open your Home Assistant instance and start setting up a new integration.

From the Home Assistant front page go to Configuration and then select Devices & Services from the list. Use the Add Integration button in the bottom right to add a new integration called Neakasa.

Help and Contribution

If you find a problem, feel free to report it and I will do my best to help you. If you have something to contribute, your help is greatly appreciated! If you want to add a new feature, add a pull request first so we can discuss the details.

Disclaimer

This custom integration is not officially endorsed or supported by Neakasa. Use it at your own risk and ensure that you comply with all relevant terms of service and privacy policies.