Karotz Integration for Home Assistant

Custom integration to control your Karotz rabbit from Home Assistant.

Features

• Status sensor: Monitor your Karotz connectivity
• LED control: RGB light with colors, pulse effects
• TTS service: Make your rabbit speak
• Wake/Sleep switches: Control rabbit state

Installation

HACS (Recommended)

1. Open HACS in Home Assistant
2. Go to "Integrations"
3. Click the three dots menu → "Custom repositories"
4. Add this repository URL and select "Integration"
5. Search for "Karotz" and install
6. Restart Home Assistant

Manual

1. Copy custom_components/karotz to your config/custom_components/ directory
2. Restart Home Assistant

Configuration

1. Go to Settings → Devices & Services → Add Integration
2. Search for "Karotz"
3. Enter your Karotz IP address

Services

karotz.say

Make your Karotz speak.

service: karotz.say
data:
  text: "Hello from Home Assistant!"
  voice: 2

Automation Example

automation:
  - alias: "Door open announcement"
    trigger:
      - platform: state
        entity_id: binary_sensor.front_door
        to: "on"
    action:
      - service: karotz.say
        data:
          text: "The front door is open"

Requirements

• Karotz with OpenKarotz firmware installed
• Karotz connected to your local network (WiFi)
• Local IP address of your Karotz (check your router or use a network scanner)
• Network connectivity between Home Assistant and Karotz (same network/VLAN)

Note: This integration uses the OpenKarotz CGI API. Make sure your Karotz responds to http://KAROTZ_IP/cgi-bin/status before adding it to Home Assistant.

Support

If you encounter issues, please open an issue on GitHub.

Author

miniil

• 🌐 Website: miniil.be
• ☕ Support my work: Tipeee

License

MIT License - see LICENSE file.