Scrypted Home Automation

Scrypted is a home automation platform primarily focusing on making camera experiences seamless.

• Streams load instantly, everywhere: Demo
• HomeKit Secure Video Support
• Google Home support: "Ok Google, Stream Backyard"

Discord

Join Scrypted Discord

Supported Platforms

• Google Home
• Apple HomeKit
• Amazon Alexa

Supported accessories:

• https://github.com/koush/scrypted/tree/main/plugins

Installation

Run on Docker

Docker Installation Instructions

Run Locally

Local Installation Instructions

Development

Debug the Scrypted Server in VSCode

# check out the code
git clone https://github.com/koush/scrypted
cd scrypted
# get the dependencies for the server and various plugins
./npm-install.sh
# open server project in VS Code
code server

You can now launch Scrypted in VSCode.

Debug Scrypted Plugins in VSCode

# this is an example for homekit.
# follow the steps above to set up the checkout.
# open the homekit project in VS Code
code plugins/homekit

# you can also build/run without VS Code with the following command.
# replace the IP of your server as necessary.
# npm run scrypted-webpack && npm run scrypted-deploy 127.0.0.1

You can now launch the HomeKit Plugin in VSCode. Please be aware that you do not need to restart the Scrypted Server if you make changes to a plugin. Edit the plugin, and launch, and the changes will apply on the running server.

Plugin Development

Want to write your own plugin? Full documentation is available here: https://developer.scrypted.app

HomeKit Secure Video Setup

1. Install Scrypted.
2. Open https://localhost:10443/ (substitute localhost appropriately for a remote server).
3. Install the Unifi, HikVision, ONVIF, or Amcrest camera plugin.
   • HKSV requires cameras with motion alerts, and these plugins provide motion alerts.
   • If there's no plugin for your camera, but it supports motion alerts using mail, use the generic RTSP, SMTP plugin, and Dummy Switch plugin. This will create a mail activated motion sensor.
   • If there's no plugin or mail support for your camera, you can install the generic RTSP Plugin, Video Analysis Plugin, and OpenCV motion detection Plugin. This will use the processing power on your server to detect camera motion.
4. Install the HomeKit Plugin.
5. Install the Rebroadcast plugin.
   • This is optional but highly recommended. It keeps a short video loop of the stream in memory leading up to the motion.
6. Pair with the Scrypted Server accessory using your HomeKit app on iOS or Mac.
7. Enable recording on the cameras in HomeKit.