A tool to capture Nest video streams locally or to the Azure cloud, even for users without a Nest subscription. The current release is tested on macOS. Windows and Linux adaptations coming soon (minor tweaks required).
NOTE: Audio recording is currently not supported.
Rename _config.json to config.json and specify the following parameters:
| Parameter | Description |
|---|---|
issueToken |
Instructions of how to obtain them are here This will have to be one only once |
cookies |
Same as above |
apiKey |
Same as above |
path |
Absolute path to local folder where content needs to be stored. Default is the script path. |
frame_rate |
Frame rate for the generated video. Default is 24. |
threshold |
Number of images that need to be combined in a video in a single buffer. Default is 200. |
width |
Image width for the capture image. Default is 1280. |
cam_retry_wait |
Determines how long to wait once the camera has been detected offline. Default is 60 seconds. |
exclude_ids |
Exclude cameras by id A list of camera ids will be provided at the start of the script Example: "exclude_ids":"['l0e5ebdad1a749b9a282a81115aa9c45', '5maa753400d54b7xa78b0fc60b5f0d0d']" |
time_stamp |
Show time and date on top left of the image Default is false Requires download Imagemagic |
clear_images |
Determines whether images are removed after video is produced. Default is false. |
produce_video |
Determines whether a video is generated after a threshold of captured images is hit. Default is false. Requires ffmpeg, instructions below |
upload_to_azure |
Determines whether the final video will be uploaded to Azure Storage. Default is false. |
az_account_name |
Name of the Azure Storage account. |
az_sas_token |
SAS token for the Azure Storage account. Should have write, list and read permissions. |
NOTE: Camera labels will be used for directory name if available!
NOTE: if you use docker do not change the capture location unless you know what you're doing
Change directory into project
cd foggycam2
Build Docker image
docker build -t foggycam2:latest .
Start Docker container
docker run -d --name foggcam2 \
-v [/full/path/to/capture/location]:/usr/local/app/foggycam2/capture/ \
-v [/full/path/to/your/config/file/config.json]:/usr/local/app/config.json foggycam2:latest
Be sure to replace above the path to recording folder
[/full/path/to/capture/location]
and configuration file
[/full/path/to/your/config/file/config.json]
ffmpeg is required generate video, download ffmpeg and place it in the tools folder, in the script root directory.
ImageMagic is required to apply timestamp on images download ImageMagic tools folder not supported in this case.
Alternatively, if you are on Linux, you can install ffmpeg with the help of the following command:
sudo apt-get install ffmpeg imagemagick
On macOS, you can install ffmpeg and ImageMagic through Homebrew:
# ghostscript is required by imagemagick
brew install ffmpeg imagemagick ghostscript
Change directory into project
cd foggycam2
pip3 install -r src/requirements.txt
Run python foggycam2.py after you configured the settings above. Exit by pressing Ctrl+C.
No claims are made in regards to the stability of the application, or its applicability for your purposes. Use at your own risk. Code is licensed under the MIT License. Code can change at any time with no prior notice.
DO NOT USE in critical security/surveillance scenarios.
On macOS, run pip install certifi and then /Applications/Python\ 3.6/Install\ Certificates.command.
Thanks to gboudreau/nest-api for G authentication, and dend/foggycam for the idea + the code for capturing images and video conversion.