# shadow-1/yi-hack-v3

Alternative Firmware for Xiaomi Cameras based on Hi3518e Chipset

Repository: https://github.com/shadow-1/yi-hack-v3
Canonical: https://ross.abutalabs.com/products/yi-hack-v3
Language: C
License: GPL-3.0
License Family: copyleft
Last push: 2019-01-15T12:21:04+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3448, "days_push": 2787, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1190, forks 155 (observed 2026-08-28T04:03:55.908330+00:00)

## What it is
A collection of Makefiles, config files, and scripts that build alternative custom firmware for Xiaomi Yi cameras based on the HiSilicon Hi3518e chipset. It adds SSH, Telnet, FTP, and web servers to the camera, enabling local control and access without relying on the vendor cloud.

## Use cases
- flash custom firmware onto a Yi Home or Yi Dome camera
- access my camera over SSH or FTP instead of the cloud app
- run a local web server on the camera for video access
- bypass region locking on Chinese-version Yi cameras with proxychains
- record motion-triggered video to a microSD card without cloud dependency
- restore stock firmware after experimenting with custom firmware

## When to choose
- you own a supported Yi camera (17CN/27US/47US, 1080p Home, Dome, 1080p Dome, Outdoor) and want local control
- you want to remove reliance on Xiaomi's cloud service
- you need SSH/FTP access to camera files and configuration

## When to avoid
- your camera model is not on the supported list or uses a different chipset
- you want a maintained, actively updated firmware (last release was 2019)
- you are not comfortable flashing firmware that could brick your device

## Facets
- artifact type: application
- maturity: maintenance
- function: security, configuration-management, file-system
- domain: iot, embedded-systems, self-hosted, hardware
- platform: embedded, cross-platform
- tags: custom-firmware, ip-camera, xiaomi-yi, hisi3518e, rtsp, surveillance, embedded-linux, linux

## Member repositories
- shadow-1/yi-hack-v3 (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:55.908330+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:23:05.771022+00:00, confidence not recorded.
  - readme: https://github.com/shadow-1/yi-hack-v3 (fetched 2026-08-28T04:03:55.908330+00:00, sha 6e2279e73fc4)
- Data as of 2026-08-30T08:39:29.467469+00:00.