Home Assistant

Yi Home Camera

The yi camera platform allows you to utilize Yi Home Cameras within Home Assistant. Specifically, this platform supports the line of Yi Home Cameras that are based on the Hi3518e Chipset. This includes:

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

To successfully implement this platform, the Home Assistant host should be capable of multiple simultaneous reads. For every concurrent Home Assistant user, a connection will be made to the camera every 10 seconds. This should normally not be a problem.

Preparing the Device

Installing Alternative Firmware

In order to integrate the camera with Home Assistant, it is necessary to install a custom firmware on the device. Instructions for doing so can be found via the yi-hack-v3 GitHub project.

Once installed, please ensure that you have enabled FTP and Telnet on your device.

Currently, version 0.1.4-beta2 of the custom firmware is the highest supported. Firmwares higher than this version use Pure-FTPd, which has a bug that prevents FFmpeg from correctly rendering video files.

Some alternative Yi firmwares enable an experimental RTSP server, which will allow you to connect to your camera via other Home Assistant camera platforms. However, this RTSP server disables the ability to use the supremely-useful Yi Home app. In order to maintain both Home Assistant compatibility and the native app, this platform retrieves videos via FTP.

Changing the FTP Password

Once the custom firmware is installed, a password must be added to the FTP server. To do so:

  1. Telnet into your camera: telnet <IP ADDRESS>.
  2. Enter root as the username and <blank> as the password.
  3. Type passwd and hit <Enter>.
  4. Enter your new password twice.
  5. Log out of Telnet.

Configuring the Platform

To enable the platform, add the following lines to yourconfiguration.yaml file:

camera:
  - platform: yi
    name: Camera
    host: '192.168.1.100'
    password: my_password_123

Configuration variables:

  • name (Required): A human-friendly name for the camera.
  • host (Required): The IP address or hostname of the camera.
  • password (Required): The password to the FTP server on the camera (from above).
  • path (Optional): The path to the raw MP4 files. Defaults to /tmp/sd/record.
  • username (Optional): The user that can access the FTP server. Defaults to root.
  • ffmpeg_arguments (Optional): Extra options to pass to ffmpeg (e.g. image quality or video filter options).

Image quality

Any option supported by ffmpeg camera can be utilized via the ffmpeg_arguments configuration parameter.

One particularly useful adjustment deals with video size. Since Yi videos are fairly large (especially on the 1080p cameras), the following configuration will bring them down to a manageable size:

camera:
  - platform: yi
    name: My Camera
    host: '192.168.1.100'
    password: my_password_123
    path: /home/camera/feed
    ffmpeg_arguments: '-vf scale=800:450'