Bring your CuboAI baby monitor into Home Assistant!
Monitor alerts, camera status, subscription, and more—directly in your smart home dashboard.
If you found this project helpful, you can buy me a coffee!
Warning:
This is an unofficial integration.
You are fully responsible for the use of your credentials and your data.
The author and contributors take no responsibility for any issues, account restrictions, or data loss that may occur.Use at your own risk.
This integration provides a massive suite of local control and real-time monitoring entities for your CuboAI cameras!
- Night Light Brightness: Native Home Assistant brightness slider (1% - 100%)
- Night Light Switch: Toggle the night light on/off
- Lullaby Player: Media player to start, stop, and select lullabies
- Lullaby Timer: Set the duration for lullabies to play
- Speaker Play Time: Adjust how long the speaker stays active
- Flip Screen: Toggle the camera's physical video orientation
- Night Vision: Switch between Auto, On, and Off
- Sleep Mode: Put the camera into privacy sleep mode
- Status LED: Toggle the physical status indicator LED
- Baby Presence: Toggle baby presence tracking
- Baby Info: Demographics (Name, Age, etc.)
- Camera State: Online/Offline/Streaming status
- Detection Statuses: Cry Detection, Cough Detection, Sleep Safety (Face Covered/Rollover)
- Cry Sensitivity: Current sensitivity level for cry detection
- Temperature & Humidity: Real-time environmental readings
- Temperature & Humidity Alerts: High/Low thresholds configured in the app
- Sleep Sensor Pad (Mat): Live BPM (Heart Rate) and Mat Battery/State
- Thermometer: Live reading and battery state of the external thermometer
- Last Alert: Image thumbnail and time of the last captured event
- Firmware Version: The active firmware installed on the camera
- WebRTC Stream: Raw stream ID for embedding ultra-low latency go2rtc video
- WiFi Diagnostics: Signal strength (RSSI), Quality (%), Noise, Channel, and SSID
- Network Info: Local IP Address and MAC Address
- Connection Details: Connection Mode (LAN vs P2P) and Connected Users count
- Hardware Info: Camera Stand Type and Session History
- Zero-Delay Local Streaming: Video is fetched directly from the camera on your local network!
- Multi-Camera Support: Add as many CuboAI cameras as you own!
- Secure Authentication: Uses native AWS Cognito SRP authentication.
Before installing CuboAI, you must install the WebRTC Camera custom component by AlexxIT (available in HACS). This provides the underlying ultra-low latency WebRTC streaming engine that this integration hooks into!
- Go to HACS in Home Assistant.
- Click the three dots menu (⋮) > Custom repositories.
- Add this repository URL:
https://github.com/niruse/cuboai - In the Category dropdown, select Integration.
- Click Add.
- Search for CuboAI in HACS and click Install.
- Restart Home Assistant to complete the installation.
- Download the
cuboaifolder from this repository - Place it in
/config/custom_components/on your Home Assistant instance - Restart Home Assistant
After adding the integration, you can click on Configure at any time to tweak its behavior. These settings can be changed seamlessly without needing to log out or remove the integration!
You can adjust:
- Download Images: Toggle whether to save event thumbnails locally.
- Alerts Count: How many recent alerts to track in the sensor.
- Max Saved Photos: The maximum number of images to keep on disk.
- Hours Back: How far back in time to fetch alerts on startup.
- Update Interval: How often to poll the API for changes.
- Camera IP (Optional): Your camera's local IP is discovered automatically, so you can leave this blank! You only need to manually enter the IP if your Home Assistant is on a different VLAN or complex network that prevents auto-discovery.
While we provide a massive suite of entities, some native CuboAI app features cannot be implemented in Home Assistant currently:
- Past Video Playback (Timeline): Home Assistant cannot fetch or stream the historical 18-hour video timeline from the camera. Only live streaming is supported.
- Native Two-Way Audio (Without Custom Card): Home Assistant's default WebRTC implementation does not natively support microphone backchannel audio without using our provided
cuboai-card.jsCustom Lovelace card. - Pan / Tilt: The CuboAI camera is fixed and does not physically support PTZ (Pan-Tilt-Zoom).
Here are example screenshots from the CuboAI integration:
Below is a sample of how you might present the alerts in a Markdown card, including event images:
💡 Replace
{{Your Baby Name}}with the actual entity suffix (e.g.,john).
type: markdown
title: 🍼 CuboAI Last 5 Alerts
content: >
{% set alerts = state_attr('sensor.cuboai_last_alert_{{Your Baby Name}}', 'alerts') %}
{% if alerts %}
| Type | Time | Image |
|------|------|-------|
{% for alert in alerts %}
| **{{ alert['type'].replace('CUBO_ALERT_','').replace('_',' ').title() }}**
|
{{ as_timestamp(alert['created']) | timestamp_custom('%Y-%m-%d %H:%M', true) }} |
{% if alert['image'] %}{% else %}-{% endif %} |
{% endfor %}
{% else %}
_No recent alerts_
{% endif %}
For the absolute best experience, we provide a Custom Lovelace Card (cuboai-card.js) that automatically wraps the WebRTC Camera card and provides a fully native app-like experience directly in Home Assistant!
-
Live Environmental Overlays: Real-time Temperature & Humidity floating directly over the video feed!
-
Baby Vitals: Live BPM (Heart Rate) overlay directly on the video if you have the Sleep Sensor Pad!
-
Smart Fallback: Automatically leverages the camera entity to enable fallback to MSE/HLS when you are outside your home network (so video always plays flawlessly over Home Assistant Cloud / Nabu Casa)!
-
Advanced Lullaby Player: A dynamic, sliding drawer menu to manage lullabies and speaker logic natively:
- Sources: Play songs directly from YouTube, or use Spotify links (currently in testing mode).
- Library Management: Create custom playlists, add your own songs, and use the built-in search logic to find tracks easily.
- Playback Control: Manage play time filters and the underlying speaker logic intuitively from the UI.
To use the custom card, you must first install the WebRTC Camera custom card (by AlexxIT) from HACS, as our card uses it under the hood for ultra-low latency video.
- Install WebRTC Camera: Go to HACS -> Frontend -> Search for "WebRTC Camera" and install it.
- Add CuboAI Card Resource:
- Navigate to Settings -> Dashboards -> Resources (You may need to click the 3 dots in the top right to see Resources).
- Click Add Resource.
- Set the URL to:
/local/cuboai-card.js?v=1 - Set the Resource Type to: JavaScript Module.
- Click Create!
- Important Cache Note: If you ever update the integration, change the version number (e.g.,
?v=2) in the Resources menu to force Home Assistant to load the newest code!
Go to your dashboard, click "Edit Dashboard", add a "Manual" card, and paste the following YAML. Provide your camera's internal device_id to link all of its sensors automatically!
type: custom:cuboai-camera-card
device_id: {cubo_id}
default_mute_state: unmutedThe card will automatically detect all the related sensors (temperature, humidity, lullaby, etc.) using your camera's device ID and seamlessly link them all together!
Once the card is on your dashboard, you have full control over the camera directly from the video feed:
- Night Light: Tap on the Night Light icon overlay to instantly toggle the camera's physical night light on or over.
- Lullabies: Click the music note icon to open the sliding Lullaby drawer. You can select a song, adjust the timer, and play/pause the music natively.
- Instant Syncing: Because this hooks directly into the Home Assistant entities, any action you take (like turning on a lullaby) will instantly synchronize across all devices. If you play a lullaby on your iPad, your phone's dashboard will immediately reflect that the lullaby is playing!
If you are experiencing issues (stream not playing, HomeKit "No Response", sensors showing as "Unknown", the configuration flow hanging), one toggle collects everything needed for a report:
- Go to Settings > Devices & Services > CuboAI > Configure
- Check "Enable debug logs" and submit, then restart Home Assistant.
- Reproduce the problem once (open the stream, wait for a sensor update, ...).
- Collect the files below and attach the relevant ones to your issue.
| Log file | Location | What it contains |
|---|---|---|
cuboai_debug.log |
HA config folder |
Every debug/info/error message from the whole integration (sensors, camera, media player, coordinator) |
go2rtc.log |
config/custom_components/cuboai/bin/ |
Streaming diagnostics (since v2.4.5): detected video codec ([mpegts] muxing ...), per-frame codec census of the first 300 frames (FICENSUS), fps/bitrate/loss health line every 10 s, GOP sync events, RTSP session negotiation |
cuboai_last_alert_debug.log |
HA config folder |
Alert polling / image download trace |
| Home Assistant log | Settings > System > Logs | The integration's debug messages also appear here automatically — no logger: changes in configuration.yaml needed |
⚠️ Redact before sharing:go2rtc.log(likego2rtc.yaml) contains your cameras'CUBOAI_UID,CUBOAI_ACCOUNTandCUBOAI_PASSWORDvalues on the exec command lines — replace them withXXXbefore attaching anything to a GitHub issue.
Log files are capped at 2 MB with rotation to protect disk space. Turning the toggle off restores the quiet defaults.
The integration runs its own internal go2rtc server for local streaming. It uses these TCP ports by default, and self-heals automatically when one is already taken (for example by Home Assistant's built-in go2rtc or the WebRTC Camera add-on):
| Port | Purpose | If already in use |
|---|---|---|
8555 |
RTSP listener (camera stream) | Hops to the next free port (usually 8557) |
1985 |
go2rtc API (snapshots, card, WebRTC) | Hops to the next free port (usually 1986) |
8556 |
WebRTC listener | Hops to the next free port |
You never need to configure anything for this: the camera entity, sensors, and the custom card all discover the effective ports through the rtsp_port attribute and internal state. A log line like go2rtc API port 1985 is already in use by another process — using port 1986 instead is informational, not an error.
Additional protections (since v2.4.4):
- Orphaned go2rtc cleanup: if a previous go2rtc process survived a hard Home Assistant crash and still holds the ports, the integration detects it (by its
cuboai_*streams) and terminates it on startup, reclaiming the standard ports. - No retry storms: if the internal go2rtc could not start at all, camera entities stop offering stream sources and live snapshots instead of hammering a port that may belong to another process (which previously caused an endless
Using native libraryloop and resource exhaustion — see issue #84).
See the CHANGELOG.md file for a detailed history of updates, bug fixes, and improvements.
Massive thanks to Fredrick (Fredde87) for his incredible reverse-engineering work and for providing the TUTK Kalay P2P protocol implementations that make the local streaming functionality of this integration possible!
We welcome:
- 🔧 Bug fixes
- 🌟 Features
- 🧠 Suggestions
Submit a PR or open an issue