Yi Home Cameras with yi-hack
roleoroleo/yi-hack_ha_integration · v0.6.0
Home Assistant custom integration for Yi cameras: yi-hack-MStar, yi-hack-Allwinner, yi-hack-Allwinner-v2, yi-hack-v5 and sonoff-hack
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
switch | Switch or outlet | |
media_player | TV, receiver or media switches | Needs its own HomeKit Bridge in accessory mode |
camera | Camera | Needs its own HomeKit Bridge in accessory mode |
binary_sensor | Sensor (motion, contact, leak, smoke…) | |
sensor | Sensor (temperature, humidity, air quality…) | |
button | Button (as a switch) | |
select | Mode picker (as switches) |
What people report
Yi cameras running yi-hack custom firmware work locally; newer Allwinner models and firmware updates have caused RTSP and compatibility problems.
- Works1
- Not working1
- Requested1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Sonoff camera (sonoff_hack firmware) | Works Local | move_to_preset service added, tested on sonoff_hackSaved copyBasic implementation of `move_to_preset service`. As I only own a sonoff camera, it was only tested on sonoff_hack firmware. It seems that preset.sh is also supported on other firmware, but I'm not sure that the extreme values are the same (0 to 14 for preset_id). Excerpt saved from GitHub on 2026-10-23. | PR #73 · 2022-02 | |
| Yi Outdoor Camera (h30ga, Allwinner v2) | Not working Local | RTSP stream unreliable after firmware 0.2.6 and base 11.1.26.1; ffmpeg or ONVIF workedSaved copyFirmware Version 0.2.6 Base Version 11.1.26.1_202301191526 Model Suffix h30ga RTSP stream is very unreliable after updating to 0.2.6 and 11.1.26.1. I have noticed that very frequently, the camera gets unresponsive for some time when trying to stream video via RTSP, and then it recovers automatically from it. Integration with home assistant does not work either after the update. When I try to stream video, I get the following error in HA: 2023-03-03 16:18:37.410 ERROR (SyncWorker_1) [custom_components.yi_hack.camera] Fetch snapshot image failed from yi_hack_a2_0efa89_cam, falling back to … Excerpt saved from GitHub on 2026-10-23. | Issue #115 · 2023-03 | |
| Yi 1080P Dome Camera (b091qp) | Requested Local | Owner will try to support this Allwinner-v2 model; issue closed staleSaved copyHello people. I've got the YI 1080P Dome Camera, with ID "A392....". I have trouble deciding about the correct hacked firmware for my model. I attached the corresponding photo file. Any help would be much appreciated. YI_DOME_CAM_ID.pdf Excerpt saved from GitHub on 2026-10-23. | Issue #84 · 2022-05 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local push
Talks to the device on your network, and the device tells Home Assistant the moment something changes.
Found automatically over
- Bonjour (zeroconf)
Details
| Installs (analytics) | 498 (0.07%) |
|---|---|
| GitHub stars | 282 |
| Latest version | 0.6.0 (2026-09-26) |
| Set up in the UI | Yes |
| Maintainers | @roleoroleo |
| License | GPL-3.0 |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
