<img height="200" src="https://raw.githubusercontent.com/alienatedsec/yi-hack-v5/master/imgs/yi-hack-v5-header.png">
<a target="_blank" href="https://discord.gg/bsKncwvRU7">
<img src="https://img.shields.io/discord/825822449449828414?logo=discord" alt="Official Discord Server">
</a>
<a target="_blank" href="https://github.com/alienatedsec/yi-hack-v5/releases">
<img src="https://img.shields.io/github/downloads/alienatedsec/yi-hack-v5/total.svg" alt="Releases Downloads">
</a>
YI-HACK-V5 firmware?The answer is simple: missing updates, RTSP and not based on the latest stock firmware (which features improvements and new cool stuff). Besides, there were no updates to Yi-Hack-V4, and I am really against that RTSP licensing model. I have contributed enough and will continue my work separately.
I am slowly releasing beta versions, and I can see lots of downloads, testing and contributions. A big thank you to the community.
This firmware will add the following features:
Currently this project supports the following cameras:
Check that you have a correct Xiaomi Yi camera. (see the section above)
Get an microSD card, preferably of capacity 16gb or less and format it by selecting File System as FAT32.
IMPORTANT: The microSD card must be formatted in FAT32. exFAT formatted microSD cards will not work. I have not formatted any of my 32GB cards in order to load the firmware. Just copy files directly and it should work.
(Click) How to format microSD cards > 32GB as FAT32 in Windows 10
For microSD cards larger than 32 GB, Windows 10 only gives you the option to format as NTFS or exFAT. You can create a small partition (e.g 4 GB) on a large microSD card (e.g. 64 GB) to get the FAT32 formatting option.
You should now have a FAT32 partition on your microSD card that will allow the camera to load the firmware files to update to yi-hack-v5.

Alternative way: * open cmd with admin permissions * run diskpart * type "list disk" * find your sd card (for example Disk 7) * type "select disk 7" * if it has one partition - type "select partition 1". If more - delete all the partitions and then create one * type "format FS=FAT32 QUICK" * done. 32GB partition in FAT32.
| Camera | rootfs partition | home partition | Remarks |
|---|---|---|---|
| Yi Home 17CN / 27US / 47US | rootfs_y18 | home_y18 | Firmware files required for the Yi Home 17CN / 27US / 47US camera. |
| Yi 1080p Home | rootfs_y20 | home_y20 | Firmware files required for the Yi 1080p Home camera. |
| Yi Dome | rootfs_v201 | home_v201 | Firmware files required for the Yi Dome camera. |
| Yi 1080p Dome | rootfs_h20 | home_h20 | Firmware files required for the Yi 1080p Dome camera. |
| Yi 1080p Cloud Dome | rootfs_y19 | home_y19 | Firmware files required for the Yi 1080p Cloud Dome camera. |
| Yi Outdoor | rootfs_h30 | home_h30 | Firmware files required for the Yi Outdoor camera. |
yi-hack-v5 folder on root path of microSD card.IMPORTANT: Make sure that the filename stored on microSD card are correct and didn't get changed. e.g. The firmware filenames for the Yi 1080p Dome camera must be home_h20 and rootfs_h20.
Remove power to the camera, insert the microSD card, turn the power back ON.
The yellow light will come ON and flash for roughly 30 seconds, which means the firmware is being flashed successfully. The camera will boot up.
The yellow light will come ON again for the final stage of flashing. This will take up to 2 minutes.
Blue light should come ON indicating that your WiFi connection has been successful.
Go in the browser and access the web interface of the camera as a website.
Depending upon your network setup, accessing the web interface with the hostname may not work. In this case, the IP address of the camera has to be found.
This can be done from the App. Open it and go to the Camera Settings --> Network Info --> IP Address.
Access the web interface by entering the IP address of the came in a web browser. e.g. http://192.168.1.5:8080
IMPORTANT: If you have multiple cameras. It is important to configure each camera with a unique hostname. Otherwise the web interface will only be accessible by IP address.
TO DO - (It happened a few times and it's often possible to recover from it)
Verify that you did not forget to upload yi-hack-v5 folder to the SD card when uploading firmware. If you did, upload it and restart the camera.
Make sure that you are using the correct app (Yi Home) to setup the wifi connection. For example, the "Xiaomi Home" app will also generate the correct QR code that will work with your camera for initial connection, but then after power is removed the settings will be lost.
Please follow this guide if you want to test new features and improvements
Special thanks to the following people and projects, without them yi-hack-v5 wouldn't be possible.
- @TheCrypt0 - https://github.com/TheCrypt0/yi-hack-v4
- @shadow-1 - https://github.com/shadow-1/yi-hack-v3
- @fritz-smh - https://github.com/fritz-smh/yi-hack
- @niclet - https://github.com/niclet/yi-hack-v2
- @xmflsct - https://github.com/xmflsct/yi-hack-1080p
- @dvv - Ideas for the RSTP stream
- @andy2301 - Ideas for the RSTP rtsp and rtsp2301
- @roleoroleo - PTZ Implementation
As much as TheCrypt0 has made it possible for the 'yi-hack-v4', the latest features are based on the work from: - @roleoroleo - https://github.com/roleoroleo
$ claude mcp add yi-hack-v5 \
-- python -m otcore.mcp_server <graph>