Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

280 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GitHub release GitHub stars GitHub License

Omlet Smart Chicken Coop Integration for Home Assistant

An integration for Home Assistant that connects your Omlet Smart Coop devices—including the Smart Automatic Chicken Coop Door, Smart Coop Fan, and Smart No Waste Chicken Feeder—enabling monitoring and control directly from Home Assistant using the official Omlet API.


Sponsor

If you find this integration useful, consider supporting development:

Buy Me A Coffee


2026.08.02 – Long-term sensor statistics

  • Fixed: Enable long-term statistics for battery level so future battery history remains available after Home Assistant purges detailed recorder history.
  • Changed: Extend measurement statistics to fan temperature, fan humidity, Wi-Fi strength, door light level, feeder feed level, and feeder light level.
  • Note: Previously purged history cannot be restored; Home Assistant retains future hourly minimum, maximum, and mean statistics.

Smart Door Features

The Smart Automatic Chicken Coop Door includes:

  • Open/close control
  • Light control (if your Omlet setup supports it)
  • Automatic detection of door state (open, closed, blocked)
  • Light & ambient sensor readings
  • Battery and Wi-Fi signal monitoring
  • Webhook support for real-time state updates

Smart Door Screenshots

Door Controls Device Details

Smart Fan Features

The Smart Coop Fan exposes granular configuration and automation entities:

Fan Modes

  • Manual mode
  • Time-based mode (On/Off with per-slot fan speed)
  • Thermostatic mode (Turn on/off based on temperature thresholds)

Entities Provided

  • Ambient temperature & humidity sensors
  • Fan state (on/off), mode, and speed
  • Time schedule entities (S1-1, S1-2, S1-3)
  • Thermostatic threshold & speed entities
  • Boost mode (if supported by your model)
  • Diagnostics entities (temperature, signal strength, battery, etc.)

Smart Fan Screenshots

Control, Configuration, and Diagnostics

Fan Control & Sensors Configuration Settings Diagnostics

Fan Modes, Actions, and Notifications

Fan Mode View Smart Fan Actions Notifications

Note: This fan is designed to ventilate (air movement), not cool like an A/C.


Smart Feeder Features

The Smart No Waste Chicken Feeder exposes:

  • Open/close control (cover entity)
  • Feed level, light level, fault/state, and mode sensors
  • Last open/close timestamps

Installation

Prerequisites

  1. A working Home Assistant installation.
  2. An Omlet account with an API key (generate in Omlet account settings).

Manual Installation

  1. Download this repository as a ZIP.
  2. Extract into:
    custom_components/omlet_smart_coop
  3. Restart Home Assistant.

HACS Installation

  1. Open HACSIntegrations.
  2. Click the menu (⋮) → Custom repositories.
  3. Add:
    https://github.com/krozgrov/ha-omlet-integration
    Category: Integration
  4. Search for Omlet Smart Coop and install.
  5. Restart Home Assistant.

Configuration

Setup

  1. Go to Settings → Devices & Services → Add Integration
  2. Search for Omlet Smart Coop
  3. Enter your API key and polling interval

Configuration Screenshots

Initial Setup Device Discovery

API Details

This integration uses the official Omlet API.

Endpoints Used

  • /device – Retrieve device information
  • /device/{deviceId}/action/{action} – Trigger actions
  • /device/{deviceId}/configuration – Update device configuration

Webhooks (Real-Time Updates)

To avoid polling delays, enable webhooks:

  1. Enable webhooks in the integration options
  2. (Optional) Set a webhook_token
  3. Integration shows a random webhook URL in a notification
  4. Add this URL in the Omlet Developer Portal → Manage Webhooks

The Omlet Developer Portal must use a full URL that is publicly reachable from Omlet's servers. Local-only URLs such as /api/webhook/..., localhost, .local hostnames, or private LAN IP addresses will fail from Omlet even if they work inside your home network.

If you configure a webhook_token, this integration validates it strictly and rejects webhooks with a missing or mismatched token. Leave the token blank while troubleshooting reachability problems, or make sure the exact same token is set in the Omlet Developer Portal.

Modes:

  • Polling + Webhooks (default)
  • Webhooks only: Enable “Disable polling” in options
  • Polling only: Disable webhooks

License

MIT License – see LICENSE for details.


Support

For issues or feature requests, open an issue:
https://github.com/krozgrov/ha-omlet-integration/issues

To debug, enable:

logger:
  default: warning
  logs:
    custom_components.omlet_smart_coop: debug

About

Custom Home Assistant integration for Omlet devices, enabling monitoring and control of Autodoors and Smart Fans. Includes features like battery level monitoring, door/light control, and updates via API.

Topics

Resources

Stars

37 stars

Watchers

3 watching

Forks

Releases

Contributors

Languages