{"id":48267109,"url":"https://github.com/timniklas/hass-neakasa","last_synced_at":"2026-04-04T21:57:56.999Z","repository":{"id":266344144,"uuid":"898093129","full_name":"timniklas/hass-neakasa","owner":"timniklas","description":"Home Assistant Neakasa Integration","archived":false,"fork":false,"pushed_at":"2025-09-30T09:27:05.000Z","size":162,"stargazers_count":58,"open_issues_count":3,"forks_count":6,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-09-30T11:32:28.925Z","etag":null,"topics":["cat","litter","m1","neakasa"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/timniklas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-03T19:21:34.000Z","updated_at":"2025-09-30T09:26:12.000Z","dependencies_parsed_at":"2024-12-28T01:19:26.940Z","dependency_job_id":"3ac68def-ad22-43e1-be21-a4c237797d6f","html_url":"https://github.com/timniklas/hass-neakasa","commit_stats":null,"previous_names":["timniklas/hass-neakasa"],"tags_count":31,"template":false,"template_full_name":null,"purl":"pkg:github/timniklas/hass-neakasa","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timniklas%2Fhass-neakasa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timniklas%2Fhass-neakasa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timniklas%2Fhass-neakasa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timniklas%2Fhass-neakasa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/timniklas","download_url":"https://codeload.github.com/timniklas/hass-neakasa/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timniklas%2Fhass-neakasa/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31416027,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T20:09:54.854Z","status":"ssl_error","status_checked_at":"2026-04-04T20:09:44.350Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cat","litter","m1","neakasa"],"created_at":"2026-04-04T21:57:56.401Z","updated_at":"2026-04-04T21:57:56.984Z","avatar_url":"https://github.com/timniklas.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Neakasa Integration for Home Assistant 🏠\n\n[![GitHub Release](https://img.shields.io/github/v/release/timniklas/hass-neakasa?sort=semver\u0026style=for-the-badge\u0026color=green)](https://github.com/timniklas/hass-neakasa/releases/)\n[![GitHub Release Date](https://img.shields.io/github/release-date/timniklas/hass-neakasa?style=for-the-badge\u0026color=green)](https://github.com/timniklas/hass-neakasa/releases/)\n![GitHub Downloads (all assets, latest release)](https://img.shields.io/github/downloads/timniklas/hass-neakasa/latest/total?style=for-the-badge\u0026label=Downloads%20latest%20Release)\n![HA Analytics](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fanalytics.home-assistant.io%2Fcustom_integrations.json\u0026query=%24.neakasa.total\u0026style=for-the-badge\u0026label=Active%20Installations\u0026color=red)\n![GitHub commit activity](https://img.shields.io/github/commit-activity/m/timniklas/hass-neakasa?style=for-the-badge)\n[![hacs](https://img.shields.io/badge/HACS-Integration-blue.svg?style=for-the-badge)](https://github.com/hacs/integration)\n\n## Overview\n\nThe Neakasa Home Assistant Custom Integration allows you to integrate your Neakasa devices with your Home Assistant setup.\n\n### Currently supported devices\n- Neakasa M1 (Cat Litter Box)\n\n### Currently supported features\n#### Sensors:\n|Sensor|Unit|Example Value|Enabled by default|\n|------|-------------|------|------|\n|Cat litter level|percent|80 %|yes|\n|WiFi RSS|dB|-60 dB|no (debug information)|\n|Last stay time|seconds|45 s|no|\n|Last usage|datetime|2024-12-07 14:52|yes|\n|Device status|idle / cleaning / leveling / flipover / cat_present / paused / side_bin_locking_panels_missing / cleaning_interrupted|idle|yes|\n|Cat litter state|insufficient / moderate / sufficient|sufficient|yes|\n|Bin state|normal / full / missing|normal|yes|\n|Cat {name}|kg|3.8|yes|\n\n#### Binary sensors:\n|Binary Sensor|Example Value|Enabled by default|\n|-------------|-------------|------------------|\n|Garbage can full|off|yes|\n\n#### Buttons:\n|Button|Action|Enabled by default|\n|------|------|------------------|\n|Clean|Cleans the litter box|yes|\n|Level|Initiates the leveling process|yes|\n\n#### Switches:\n|Switch|Enabled by default|\n|------|------------------|\n|Kitten mode|no (rare edgecase)|\n|Child lock|yes|\n|Automatic cover|yes|\n|Automatic leveling|yes|\n|Silent mode|yes|\n|Automatic recovery|no (potentialy dangerous!)|\n|Unstoppable cycle|yes|\n\n## Installation\n\n### HACS (recommended)\n\nThis integration is available in HACS (Home Assistant Community Store).\n\n1. Install HACS if you don't have it already\n2. Open HACS in Home Assistant\n3. Go to any of the sections (integrations, frontend, automation).\n4. Click on the 3 dots in the top right corner.\n5. Select \"Custom repositories\"\n6. Add following URL to the repository `https://github.com/timniklas/hass-neakasa`.\n7. Select Integration as category.\n8. Click the \"ADD\" button\n9. Search for \"Neakasa\"\n10. Click the \"Download\" button\n\n### Manual installation\n\n#### from downloaded zip archive\nTo install this integration manually you have to download [_neakasa.zip_](https://github.com/timniklas/hass-neakasa/releases/latest/) and extract its contents to `config/custom_components/neakasa` directory:\n\n```bash\nmkdir -p custom_components/neakasa\ncd custom_components/neakasa\nwget https://github.com/timniklas/hacs_blitzerde/releases/latest/download/neakasa.zip\nunzip neakasa.zip\nrm neakasa.zip\n```\nrestart Home Assistant.\n\n#### Installation from git repository\n\nwith this variant, you can easily update the integration from the github repository.\n\n##### First installation:\n\n```bash\ncd \u003cto your Home Assistant config directory\u003e\ngit clone https://github.com/timniklas/hass-neakasa\nmkdir custom_components\ncd custom_components\nln -s ../hass-neakasa/custom_components/neakasa/ .\n```\n\nrestart Home Assistant.\n\n##### update the existing installation:\n\n```bash\ncd \u003cto your Home Assistant config directory\u003e\ncd hass-neakasa/\ngit pull\n```\n\nrestart Home Assistant.\n\n\n## Configuration\n\n### Using UI\n\n[![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=neakasa)\n\nFrom the Home Assistant front page go to `Configuration` and then select `Devices \u0026 Services` from the list.\nUse the `Add Integration` button in the bottom right to add a new integration called `Neakasa`.\n\n## Troubleshooting Tips / Known Issues\n\n1. When you discover  that the mobile app is starting over and over, beginning again with the login steps, then you should use this HA integration with a different account than with the app. Create a second account and use the share function in the app - simply share the device with the second account\n2. powercycle the litterbox\n3. reset the litterbox and reintegrate it\n4. open an issue\n\n## Help and Contribution\n\nIf you find a problem, feel free to report it and I will do my best to help you.\nIf you have something to contribute, your help is greatly appreciated!\nIf you want to add a new feature, add a pull request first so we can discuss the details.\n\n## Disclaimer\n\nThis custom integration is not officially endorsed or supported by Neakasa.\nUse it at your own risk and ensure that you comply with all relevant terms of service and privacy policies.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimniklas%2Fhass-neakasa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimniklas%2Fhass-neakasa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimniklas%2Fhass-neakasa/lists"}