Skip to content
EpicLPer edited this page Mar 21, 2019 · 28 revisions

Below you will find a getting started guide for the Yi-hack-v4 firmware.

NOTE: The following method assumes you have already setup your camera using the official Yi app and added it to your WiFi network.

Supported Cameras

Yi-hack-v4 currently supports the following devices:

  • Yi Home 17CN / 27US / 47US
  • Yi 1080p Home
  • Yi Dome
  • Yi 1080p Dome
  • Yi 1080p Cloud Dome
  • Yi 1080p Outdoor

Unsupported Cameras

Yi-Hack-v4 currently doesn’t support the following devices:

  • Yi 1080p Home v2

Firmware Download

Yi-hack-v4 is in the early stages of development and the firmware and associated scripts are only available to supporters of the project while it's being tested.

To become a supporter please visit the projects Discord server, make a donation and let @crypto know.

Preparing the Firmware

Requirements:

  1. A computer.
  2. Micro SD Card and Reader.
  3. One of the above supported cameras.

Format the SD card as FAT32 place the firmware for your specific camera in the root of the SD card like the example below:

root
│ home_h20
│ rootfs_h20

NOTE: Make sure the file names are not changed and do not contains any file extensions. On macOS use 'get info' on the files and make sure 'don't show extension' is disabled.

Flashing the Firmware

Place the prepared SD card back into the camera and power it on. The orange light on the camera will begin to blink as the firmware is flashed to the camera. After a short time the camera will start correctly and the blue status light should show (if enabled).

🎉 Congratulations you have now flashed your camera with Yi-Hack-v4.

Accessing the Flashed Camera

You can obtain the camera_ip by using the Yi app and navigate to Camera Settings > Network Info, looking in your routers DHCP table or use an app like Fing on iOS/Android to scan your network.

You should now be able to connect to the camera via any the following methods:

Method Details
Web. http://camera_ip
FTP. camera_ip
SSH. ssh username@camera_ip
Telnet. telnet username@camera_ip

The default username and password are below:

Username Password
root (none)

NOTE: It is HIGHLY recommended to change this password after connecting when using your camera as a full security camera that's connected for longer periods to your network! To do so connect via SSH and use passwd to change it to a new one. We do not take responsibility for internet-hacked cameras if you don't change this!

NOTE: If you had previously connected the camera to using the official Yi app you should still be able to access the camera as before.

Upgrading the Firmware

If a newer version of the firmware has been released there are a few methods available to update the camera.

Method 1.

Connect to the camera via ftp and navigate to the following directory:

/tmp/sd

Place the expanded files for your particular camera in this location. Make sure again to check the naming is exactly as downloaded removed any file extension.

Rebooting the camera (either through an ssh/telnet session) will start the upgrade process.

Method 2.

Power off the camera and place the SD card into a computer and copy the expanded files into the root directory replacing any exiting firmware files. Place the SD card back into the camera and plug back into the power to start the upgrade process.

NOTE: You cannot update the same version of the firmware due to the checks that are made during the boot process. If you need to reflash the same version you would need to downgrade first then perform the desired upgrade. This may change in the future.

The upgrade process is likely to change and be added to the Web GUI in the future making the process simpler.

Installing VIEWD and RSTPV4

viewd in combination with rtspv4 is used to get a functioning RTSP stream from the camera. This is useful for viewing the camera's stream on VLC or to connect the camera to your own security server as example.

NOTE: viewd is currently closed source donationware and can't be compiled. This is mostly to prevent others from monetizing this function, as example Chinese sellers selling pre-hacked cameras and such. Sadly those exist... Keep in mind that you don't have to donate insane amounts, even just 10 Cents as example are accepted! A single year of Yi-Cloud subscription already costs ~40$, to put things into perspective.

Required Steps:

  • Join the Discord Server mentioned on the project's main page
  • Donate any kind of amount (no minimum set): PayPal
  • Mention Crypto on Discord to be a verified Supporter
  • You should then get access to the #supporters channel

NOTE: *Please make sure to download the latest firmware pinned in the #supporters and flash it before continuing with *