Changelog

See the changelog for changes between versions of this package.

Installation instructions

After Homebridge has been installed:

• (sudo) npm i -g homebridge-yi-camera@latest

You also need a programm to handle the stream. I recommend to use FFmpeg

See OS instructions for detailed installation instruction regarding to your OS

Basic configuration

{
 "bridge": {
   ...
 },
 "accessories": [
   ...
 ],
 "platforms": [
   {
     "platform": "YiCamera",
     "videoProcessor": "ffmpeg",
     "cameras": [
       {
         "name": "Flur",
         "active": true,
         "videoConfig": {
           "source": "-rtsp_transport tcp -re -i rtsp://192.168.178.31/ch0_0.h264",
           "maxWidth": 1920,
           "maxHeight": 1080,
           "maxFPS": 30
         }
       }
     ]
   }
 ]
}

See Example Config for more detailsand options!

OS instructions (FFmpeg)

Mac OS:

To install this utility on OS X, just head over to ffmpeg.org, download the release relative to your Macs architecture. Then put the application into an accessible directory and run it from command line. Another way is using HomeBrew

For example

brew install ffmpeg --with-fdk-aac --with-ffplay --with-libass --with-libvorbis --with-libvpx --with-rtmpdump --with-openh264 --with-tools

Windows:

To install this utility on Windows, head over to ffmpeg.org and follow the download link, using your architecture. Then place the downloaded software into an accessible directory and run from command line.

Linux:

To install this utility on Unix, just follow the instructions found at ffmpeg.org

To check if ffmpeg is installed correctly and see a list of available commands try running the following command in the command line:

ffmpeg -help

Homebridge Docker:

Add FFmpeg to packages

PACKAGES=ffmpeg

GUI Access

After setting up the gui part in config.json, just open https://localhost: and you are ready. Credentials are these setted up in config.json as username and password.

iOS Web Application

• Open Safari. Other browsers, such as Chrome, won’t work for this.
• Navigate to https://localhost:
• Tap the Share button at the bottom of the page.
• On the bottom row of icons, scroll over until you see Add to Home Screen and tap this.
• On the next screen, choose a name for the link on your home screen. You’ll see the link so you can confirm it, as well as the site’s favicon that becomes its “app” icon.
• Now just tap the new app on your home screen, and it will open the website in its own navigation window, independent of Safari.

Note: Maybe othe cameras than yi will also work with this plugin, but you need at least disable MQTT. Because MQTT is a function especially for the hack!

(see Yi-Hack v4 Supported Cameras)

Supported clients

This plugin has been verified to work with the following apps on iOS 12.2 and iOS 12.3 Beta:

• iOS 12
• Apple Home
• All 3rd party apps like Elgato Eve etc (recommended for custom characteristics)
• Homebridge v0.4.49

Supported Cameras

• Yi Home 720p (17CN)
• Yi Home 720p (27US)
• Yi Home 720p (47CN)
• Yi Dome 720p (Generic)
• Yi Dome 720p (43US)
• Yi Dome 720p (63US)
• Yi Dome 1080p (Generic)
• Yi Dome 1080p (45US)
• Yi Dome 1080p (65US)
• Yi Home 1080p (version 1)
• Yi Home 1080p (6FUS, Work in progress)
• Yi Cloud Dome 1080p
• Yi Outdoor

Contributing

• This plugin uses a modified version of the homebridge-camera-ffmpeg plugin from @KhaosT

• Credits goes also to @phoboslab for the wonderful decoder AND @TheCrypt0 for the awesome hack!

You can contribute to this homebridge plugin in following ways:

• Report issues and help verify fixes as they are checked in.
• Review the source code changes.
• Contribute bug fixes.
• Contribute changes to extend the capabilities

Pull requests are accepted.

Troubleshooting

If you have any issues with the plugin then you can run this plugin in debug mode, which will provide some additional information. This might be useful for debugging issues. Just open your config.json and set debug to true!

Licens

MIT License

Copyright (c) 2019 Seyit Bayraktar

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.