twastvedt / foggycam

📹 A tool to capture Nest video streams locally

Home Page:http://den.engineering

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

📹 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

For timestamp functionality you'll need imagemagick:

sudo apt-get install imagemagick

On macOS, you can install imagemagick through Homebrew as well:

brew install imagemagick

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.

About

📹 A tool to capture Nest video streams locally

http://den.engineering

License:MIT License


Languages

Language:Python 98.0%Language:Dockerfile 2.0%