šŸ“¹ A tool to capture Nest video streams locally
Clone or download
Latest commit 38d4f45 Nov 29, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src Update test Nov 29, 2018
.gitignore Starting to work on tests Nov 29, 2018
.travis.yml Update location for tests Nov 29, 2018
Dockerfile Update Feb 19, 2018
LICENSE Update Feb 19, 2018
README.md Update README.md Nov 29, 2018
_config.json Update Feb 19, 2018

README.md

šŸ“¹ foggycam

Build Status

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.

How To Configure

Rename _config.json to config.json and specify the following parameters:

Parameter Description
username Nest account username.
password Nest account password.
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.
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.
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.

If you want to generate video, you will need to download ffmpeg and place it in the tools folder, in the script root directory.

Alternatively, if you are on Linux, you can install ffmpeg with the help of the following command:

sudo apt-get install ffmpeg

On macOS, you can install ffmpeg through Homebrew:

brew install ffmpeg

How To Start

Make sure you install the requirements for the project, by cd-ing in the folder with the project, and running:

pip install -r requirements.txt

Run python start.py after you configured the settings above. Exit by pressing Ctrl+C.

Disclaimer

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.

Troubleshooting

Getting urlopen error [SSL: CERTIFICATE_VERIFY_FAILED]

On macOS, run pip install certifi and then /Applications/Python\ 3.6/Install\ Certificates.command.