nest2img is a simple CLI utility for grabbing an image from Nest live video link and saving it to a local
nest2img is compatible with Nest cameras which are managed with the Nest app and can share videos with a public or password-protected link such as
https://video.nest.com/live/<token>. See this Google Nest support thread for a comparison of camera sharing options.
Unfortunately it is not compatible with cameras shared via the Google Home app, since those use different authentication and API’s, however contributions are welcome!
For now, the recommended installation method is using
- Ensure you have a relatively-recent version of Go installed locally (1.18 or higher recommended)
- Ensure you have
$GOBINsomewhere on your
go install github.com/nulltrope/nest2imgto install
At a minimum, you’ll need your camera’s
password (if the live link is password-protected).
To find the token, copy the last portion of your live link which will look something like
nest2img with the token and password (if required):
nest2img -token <token> -password <password>
If everything worked, you should see an image
out.png in the current directory with a snapshot from your camera’s live feed. Congrats!
Full CLI Flags
Here’s a full output of all CLI flags available to
-debug enable debug logging -out string the output file, must end in .png or .jpeg (default "out.png") -password string the camera's password, if link is password-protected -quiet disable all logging -token string the camera's token -width int the image width in pixels (default 512)
This is very much a side project for me, but contributions or feature requests via GitHub issues are very welcome, with the caveat that I may or may not get to all of them 🙂
Some things I’m considering for the future in no particular order:
- Home Assistant integration, to be able to pull an image on some trigger condition
- More intuitive logging and configuration options
- More modular code structure, split into packages for import by other projects