Homebridge-nest-cam NPM

homebridge-nest-cam

View your Nest cams in HomeKit using Homebridge with this plugin.

FAQ	Troubleshooting

Notes

This plugin does not use the old access token authentication method as Google is urging users to switch to Google accounts.

Installation

Install this plugin using: npm install -g --unsafe-perm homebridge-nest-cam
Add google authentication to config.json
Run Homebridge

FFmpeg

By default, libx264 is used as the h264 encoder. If you would like to use a hardware-accelerated encoder instead, refer to the h264 Hardware Encoders Wiki.

Setting up the Config.json

googleAuth

Google Accounts are configured using the "googleAuth" object in config.json, which contains three fields, "issueToken", "cookies" and "apiKey", and looks like this:

{
    "platform": "Nest-cam",
    "ffmpegCodec": "libx264",
    "options": {
      "motionDetection": true,
      "streamingSwitch": true,
      "disableAudio": false
    },
    "googleAuth": {
        "issueToken": "https://accounts.google.com/o/oauth2/iframerpc?action=issueToken...",
        "cookies": "SMSV=ADHTe..."
    }
}

If the plugin is installed globally, run homebridge-nest-cam login, otherwise, ensure that you are in the plugin's root directory and run node dist/login.js.
Login to your Nest account.
Copy the output to your config.json.

Notes:

If the steps above do not work, refer to the manual authentication method.
You may need to reauthenticate periodically due to your Google account settings.
If your account has 2 factor authentication, use the -h flag.
If you are unable to open the chromium browser, install it manually and specify its path via the -p flag.

options

Extra options can be enabled/disabled depending on which switches and sensors you would like to see in the Home app. Here is the current list of available options:

Name	Description	Type
streamQuality	The quality of the stream from LOW to HIGH	number (1-3)
alertCheckRate	How often to check for alerts	number (seconds)
alertCooldownRate	How long between consecutive alert notifications	number (seconds)
alertTypes	What type of alerts to receive	array
importantOnly	Only send notifications on events considered important	boolean
motionDetection	Enable/disable the motion sensors	boolean
doorbellAlerts	Enable/disable doorbell ring notifications	boolean
doorbellSwitch	Enable/disable doorbell automation switch	boolean
streamingSwitch	Enable/disable the ability to turn the camera on or off	boolean
chimeSwitch	Enable/disable the ability to turn the doorbell chime on or off	boolean
audioSwitch	Enable/disable the ability to turn the camera audio on or off	boolean
pathToFfmpeg	Specify the path to a custom FFmpeg binary	string
structures	Specify the structure ID of which structures' cameras to see	array

Features

View cameras within homekit.
Receive notifications and set routines for motion or when the doorbell is rang.
Receive notifications for specific motion events.
Listen and talk back to people on equiped cameras.
Enable/disable the indoor chime on Hello doorbells.

Join the Discord

Unfortunately, there is no way for me to test every subscription, camera type, and feature. If you would like to help me test new features and enhancements, or if you have general questions or need support, join the official Homebridge Discord Server.

Credits

This plugin was originally developed by KhaosT.

This plugin was converted to typescript using both homebridge-ring and homebridge-examples.

Donate to Support homebridge-nest-cam

This plugin was made with you in mind. If you would like to show your appreciation for its continued development, please consider making a small donation.