https://github.com/hasscc/catlink
🐈️ Catlink scooper component for HomeAssistant
https://github.com/hasscc/catlink
catlink custom-component home-assistant
Last synced: 5 months ago
JSON representation
🐈️ Catlink scooper component for HomeAssistant
- Host: GitHub
- URL: https://github.com/hasscc/catlink
- Owner: hasscc
- License: apache-2.0
- Created: 2021-12-02T12:07:18.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-09-04T19:02:29.000Z (almost 2 years ago)
- Last Synced: 2025-04-09T14:09:15.446Z (about 1 year ago)
- Topics: catlink, custom-component, home-assistant
- Language: Python
- Homepage:
- Size: 105 KB
- Stars: 38
- Watchers: 3
- Forks: 15
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
CATLINK v2 Integration for Home Assistant
+
Made easy, for 😸 lovers.
---
### Table of Contents
- [Features](#features)
- [Installation](#installation)
- [Easy way](#easy-way)
- [Manually](#manually)
- [Supported Devices and Operations](#supported-devices-and-operations)
- [Scooper SE](#supported-devices-and-operations)
- [Scooper PRO](#supported-devices-and-operations)
- [How to Configure?](#how-to-configure)
- [Services (Optional)](#services-optional)
- [Changelog](#changelog)
- [How to contribute?](#how-to-contribute)
- [Disclaimer on Using Logos](#disclaimer-on-using-logos)
The CatLINK custom integration provides seamless support for integrating your CatLINK Scooper and Litterbox devices into Home Assistant. This integration allows you to monitor, control, and automate your CatLINK devices directly from your Home Assistant setup, enhancing the convenience and care of your feline friends.
#### Features:
- **Scooper/Litterbox Device Integration**: Effortlessly connect your CatLINK Scooper and Litterbox devices to Home Assistant, enabling centralized control and monitoring within your smart home environment.
- **Real-Time Status Monitoring**: Track essential metrics such as work status, alarm status, weight, litter weight, cleaning times, and more. All relevant data is available in real-time, ensuring you stay informed about your pet's litterbox usage.
- **Mode Selection**: Choose between different modes of operation (Auto, Manual, Time) to customize the behavior of your CatLINK devices according to your needs and preferences.
- **Advanced Actions**: Perform specific actions such as initiating a clean cycle, pausing the device, or changing the litter bag directly from Home Assistant.
- **Comprehensive Logging**: Access detailed event logs for all activities, including manual and auto-clean events, cat visits with associated cat details, and other device operations. This feature helps you keep track of your pets' habits and the device's performance.
- **Customizable Alerts and Automations**: Set up notifications and automate tasks based on the state of your CatLINK devices. For example, receive alerts when the litterbox is full or automatically start a cleaning cycle during quiet times.
- **Entity Attributes**: The integration exposes various attributes related to your CatLINK devices, such as litter weight, total and manual clean times, alarm status, and more, allowing for detailed customization and automation.
---
# Installation:
### Easy way
[](https://my.home-assistant.io/redirect/hacs_repository/?category=integration&owner=hasscc&repository=catlink)
### Manually
#### Method 1: Manually installation via Samba / SFTP
> Download and copy `custom_components/catlink` folder to `custom_components` folder in your HomeAssistant config folder
#### Method 2: Onkey shell via SSH / Terminal & SSH add-on
```shell
wget -O - https://get.hacs.vip | DOMAIN=catlink REPO_PATH=hasscc/catlink ARCHIVE_TAG=main bash -
```
#### Method 3: shell_command service
1. Copy this code to file `configuration.yaml`
```yaml
shell_command:
update_catlink: |-
wget -O - https://get.hacs.vip | DOMAIN=catlink REPO_PATH=hasscc/catlink ARCHIVE_TAG=main bash -
```
2. Restart HA core
3. Call this [`service: shell_command.update_catlink`](https://my.home-assistant.io/redirect/developer_call_service/?service=shell_command.update_catlink) in Developer Tools
2. Restart HA core again
## Supported Devices and Operations
Scooper SE
Operations
- Changing Operation Mode (Auto, Manual, Time)
- Actions (Cleaning, Pause, Change Garbage Bag)
- Wastebin Full flag
- Litter weight measurement
- Litter days left
- Deodorant replacement countdown in days
- (NEW) Reset litter and deodorant buttons
- Occupacy flag
- Cleaning count
- Knob status
- Garbage Tobe status
- Online status
- Logs & Errors
- Entities: sensor, binary sensor, select, switch, button
Scooper PRO
Operations
- Changing Operation Mode (Auto, Manual, Time, Empty)
- Actions (Start, Pause)
- Deodorant replacement countdown in days
- Litter days left
- Litter weight measurement
- Reset litter and deodorant buttons
- Occupacy flag
- Cleaning count
- Temperature (Celsius)
- Humidity
- Online status
- Logs & Error
- Entities: sensor, binary sensor, select, switch, button
Feeder Young
Operations
- Feed Button
- Food tray weight
- Online status
- Logs & Error
- Entities: sensor, binary sensor, button
#### Additional supported devices
Open-X/C08
Operations
- Changing operation mode (Auto, Manual, Scheduled)
- Actions (Clean, Pause, Cancel, Pave)
- Litter weight, remaining days, and deodorant countdown
- Quiet mode, child lock, indicator light, keypad tone
- Notice switches and pet stats
- Entities: sensor, binary sensor, select, switch, button
Scooper Pro Ultra (limited support)
Operations
- Litter remaining days
- Deodorant countdown
- Total clean time
- Logs
- Entities: sensor
#### Cats
Smart collars (via the Cats integration)
Operations
- Activity and status sensors
- Weight and body metrics sensors
- Presence and last seen tracking
- Entities: sensor, binary sensor
### How to Configure?
> ! Recommend sharing devices to another account, because you can keep only one login session, which means that you'll have to re-login to CATLINK each time your HA instance pulls the data.
Just use ConfigFlow. Enter your phonenumber (eg. +493034994004) and password.
That's it.
It will automatically discover your Region, Cats & Devices.
## Services (Optional)
#### Request API
```yaml
service: catlink.request_api
target:
entity_id: sensor.scooper_xxxxxx_state # Any sensor entity in the account
data:
api: /token/device/union/list/sorted
params:
key: val
```
## Changelog
See `CHANGELOG.md` for release notes.
### How to contribute?
Please visit [CONTRIBUTE](/CONTRIBUTE.md), and be aware of [this](/CODE_OF_CONDUCT.md).
---
### Disclaimer on Using Logos
Disclaimer on Using Logos: Please note that the logos used in this documentation, including the CatLINK and Home Assistant logos, are the property of their respective owners.
Trademark Acknowledgment: The CatLINK and Home Assistant logos are trademarks of their respective companies. This documentation uses these logos solely for informational and illustrative purposes. No endorsement by or affiliation with the trademark holders is implied.
Usage Restrictions: Ensure that you have the appropriate permissions or licenses to use these logos in your own materials. Unauthorized use of logos can result in trademark infringement or other legal issues.
Modifications: If you modify or resize the logos for use in your projects, ensure that the integrity of the logos is maintained and that they are not used in a misleading or inappropriate manner.
By using these logos in your documentation or materials, you acknowledge and agree to comply with all applicable trademark laws and the usage guidelines set by the respective trademark holders.