KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #ai-agent #developer-tools #claude-code #codex #deepseek-harness #ai-agents #cli #react #mcp

yi-hack-v3

★ 1,190 Open GitHub ↗

Alternative Firmware for Xiaomi Cameras based on Hi3518e Chipset

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# yi-hack-v3

This project is a collection of config files, Makefiles and scripts to allow custom firmware images to be created and deployed to extend the functionality of Xiaomi Cameras based on HiSilicon Hi3518e V200 chipset.

Currently this project supports:
* Yi Home 17CN / 27US / 47US
* Yi 1080p Home
* Yi Dome
* Yi 1080p Dome
* Yi Outdoor

![Alt text](https://raw.githubusercontent.com/shadow-1/yi-hack-v3/master/yi-cam.png)

## Acknowledgments

Special thanks for [GearBest](https://www.gearbest.com) for generously donating a Yi Dome camera so I could further develop this firmware. Without having a camera to develop on, it would not have been possible to develop past the initial firmware releases.
Consider having a look at the following special GearBest links:
* [Yi Home](https://www.gearbest.com/ip-cameras/pp_193393.html?lkid=11854175 "GearBest Yi Home")
* [MiJia Smart Camera](https://www.gearbest.com/ip-cameras/pp_615275.html?lkid=11854258 "GearBest MiJia Smart Camera")
* [MiJia Smart 720p](https://www.gearbest.com/ip-cameras/pp_633879.html?lkid=12428807 "GearBest MiJia Smart 720p Camera")

I would like to also thank the following projects for their efforts on other Xiaomi cameras and giving inspiration for me to develop and publish my own custom firmware.

**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

## Table of Contents

- [Features](#features)
- [Cameras that are Region Locked to Mainland China](#cameras-that-are-region-locked-to-mainland-china)
- [Getting Started - Step by Step Guide](#getting-started---step-by-step-guide)
- [Which Smartphone App to use?](#which-smartphone-app-to-use)
   - [Chinese Version of the Camera](#chinese-version-of-the-camera)
   - [International Version of the Camera](#international-version-of-the-camera)
- [Using the Camera](#using-the-camera)
   - [Telnet Server](#telnet-server)
   - [FTP Server](#ftp-server)
   - [Startup Shell Script](#startup-shell-script)
   - [External Programs and Libraries](#external-programs-and-libraries)
   - [Which Version is Installed?](#which-version-is-installed)
- [Going Back to Stock Firmware](#going-back-to-stock-firmware)
- [Development](#development)

## Features
The supported cameras have the following features by default:
* Wifi
* Motion detection - a video file is generated if a motion have been detected in the last 60 seconds.
* Send video/audio data through a cloud service to allow people to view camera data from their smartphone wherever they are.
* Setup through smartphone app.
* Local video storage on microSD card.

This firmware includes:
* SSH server - _Enabled by default._
* Telnet server - _Disabled by default._
* FTP server - _Enabled by default._
* Web server - _Enabled by default._
* Proxychains-ng - _Enabled by default. Useful if the camera is region locked._

## Cameras that are Region Locked to Mainland China
This firmware includes Proxychains-ng. This allows communication between the camera and Xiaomi server to be routed through a proxy server. If Proxychains-ng is configured with a proxy server from Mainland China, the camera will no longer be region locked.

Performance is not degraded as the cameras video/audio feed is not routed through the proxy server.

## Getting Started - Step by Step Guide
1. Check that you have a correct Xiaomi Yi camera. Currently four (4) series of cameras are supported: 
* Yi Outdoor
* Yi Home 17CN / 27US / 47US Camera
* Yi 1080p Home Camera
* Yi Dome Camera
* Yi 1080p Dome Camera

2. 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._**

3. Get the correct firmware files for your camera from this link: https://github.com/shadow-1/yi-hack-v3/releases

| Camera | rootfs partition | home partition | Remarks |
| --- | --- | --- | --- |
| **Yi Home** | - | - | Not yet supported. |
| **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 Outdoor** | rootfs_h30 | home_h30 | Firmware files required for the Yi Outdoor camera. |

4. Save both files 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._**

5. Remove power to the camera, insert the microSD card, turn the power back ON.

6. 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.

7. Install the _correct_ smartphone app onto your smartphone. Refer to [Which Smartphone App to use?](#which-smartphone-app-to-use) for guidance.

8. Configure the camera as normal by scanning the QR code on the smartphone. Ensure that your smartphone is connected to 2.4GHz wireless network.

9. Blue light should come ON indicating that your WiFi connection has been successful.

10. Although the WiFi connection on your camera has been successful but you won't be able to pair it with your phone yet until you perform the following steps.

11. Go in the browser and access the web interface of the camera as a website. By default, the hostname of the camera is `yi-hack-v3`. Access the web interface by entering the following in your web browser: http://yi-hack-v3

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 found on most routers. Alternatively you can install an app on your phone to scan your wifi network. Android users can install "Network Scanner" and run it to find the IP address of the camera. e.g. 192.168.1.5. The camera should be listed as . Access the web interface by entering the IP address of the came in a web browser. e.g. http://192.168.1.5

**_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. The hostname can be configured from the web interface of the camera on the "System Config" page._**

12. It will open a configuration page of the camera.
![Alt text](https://raw.githubusercontent.com/shadow-1/yi-hack-v3/master/web_interface.png)

13. For those with the **International Version of the Camera**. ProxyChains-ng is not required. It can be disabled by going to "System Config", select "No" against Proxy-Chains-ng and clicking "Apply". No further configuration is required.

14. For those with the **Chinese Version of the Camera**. ProxyChains-ng is required to be configured. The quickest way to configure ProxyChains-ng is to utilise the Download Proxy List feature in the firmware.

15. Click "Download Proxy List".

16. Click "Download Proxies". By default, the firmware will download a list of proxy servers and choose 10 at random. Each proxy server is automatically tested to ensure that it is operational. Each operational proxy server located within Mainland China is selected to be saved automatically.
![Alt text](https://raw.githubusercontent.com/shadow-1/yi-hack-v3/master/download_proxy_list.png)

17. Once the proxy server list has been generated and tested. Click "Save Selected Proxies". Every proxy server which has the check box next to it checked will be saved.
![Alt text](https://raw.githubusercontent.com/shadow-1/yi-hack-v3/master/download_proxy_list_completed_example.png)

18. Wait 30-40 seconds and try to connect from your smartphone.

## Which Smartphone App to use?
### Chinese Version of the Camera
The Chinese version of the camera will **only** work with the Chinese version of the app.

Android users, download the Chinese version of the Yi Home app. It is available from the Mi Store.
Link: http://app.mi.com/details?id=com.ants360.yicamera

Alternatively, an APK file which can be installed manually is available from here under the directory 'Yi Home - Android': https://app.box.com/s/cibs7n1mgvhqaqjlidtveegu1uajt5yr

iPhone users will need to change their App Store to the Chinese App Store and install Chinese version of the Yi Home app.
Link: https://itunes.apple.com/cn/app/xiao-yi-zhi-neng-she-xiang-ji/id931168730

### International Version of the Camera
The International version of the camera will **only** work with the International version of the app.

Android users can download the International version of the Yi Home app from the Google Play Store. Link: https://play.google.com/store/apps/details?id=com.ants360.yicamera.international

iPhone users can download the International version of the Yi Home app from the App Store. Link: https://itunes.apple.com/au/app/yi-home/id1011626777?mt=8

## Using the Camera

### SSH Server
The SSH server is on port 22.

Default user is root. Password is _blank_.

### Telnet Server
The telnet server is on port 23.

Default user is root. Password is _blank_.

### FTP Server
The FTP server is on port 21.

Default user is root. Password is _blank_.

### Startup Shell Script
On the microSD card. The following shell script is executed after the camera has booted up within a folder named `yi-hack-v3`:

```
startup.sh
```

### External Programs and Libraries
Xiaomi cameras have very limited free space available for additional programs or libraries. However these can be stored on the microSD card where they can be utilised from there.

Place additional programs compiled for the camera in either of these folders on the microSD card:

```
yi-hack-v3\bin
yi-hack-v3\sbin
```

Place additional libraries compiled for the camera in the following folder on the microSD card:

```
yi-hack-v3\lib
```

### Which Version is Installed?
The base firmware (Xiaomi firmware) version and y-hack-v3 firmware version is accessible through the webinterface on the About page.

## Going Back to Stock Firmware
Recovery images have been created to go back to stock firmware. You can download the recovery images from here under the directory 'yi-hack-v3/Recovery': https://app.box.com/s/cibs7n1mgvhqaqjlidtveegu1uajt5yr

| Camera | rootfs partition | home partition | Remarks |
| --- | --- | --- | --- |
| **Yi Home** | rootfs | home | Stock firmware is version 1.8.7.0D_201708091510. |
| **Yi Home 17CN** | rootfs_y18 | home_y18 | Stock firmware is version 1.8.7.0C_201705091058. |
| **Yi Home 27US / 47US** | rootfs_y18 | home_y18 | Stock firmware is version 1.8.7.0A_201702081101. |
| **Yi 1080p Home** | rootfs_y20 | home_y20 | Stock firmware is version 2.0.0.1A_201612051401. |
| **Yi Dome** | rootfs_v201 | home_v201 | Stock firmware is version 1.9.1.0F_201701041701. |
| **Yi 1080p Dome** | rootfs_h20 | home_h20 | Stock firmware is version 1.9.2.0C_201611011902. |
| **Yi Outdoor** | rootfs_h30 | home_h30 | Stock firmware is version 3.0.0.0A_201710131102. |

## Development
**TODO**

yi-hack-v3

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README