README.md

Ring Doorbell using Google Drive storage

This project is made possible by:

• ring-client-api: for saving recordings
• python-ring-doorbell: for listening for events

Requirements

• Docker
• Google Drive Account Setup
  • Enable the Drive API and download the credentials.json
    • Add the file to app/monitor/credentials.json
  • Create the OAuth client ID and download the client_secret.json
    • Add the file to app/monitor/client_secret.json
• Ring
  • Create a credentials.env file with the following variables:

    • RING_EMAIL=<email>
      RING_PASS=<password>
      GDRIVE_FOLDER_ID=<folder_id>

      • GDRIVE_FOLDER_ID (optional) the ID of the folder on Google Drive where the files will be uploaded to. To get the ID, go to Google Drive on the browser, select the folder where the recordings will be uploaded to, and copy the last part of the URL.
        • i.e. 3rE4Hg5vnPfOSZgjq9IrFGk6FWjrJs4Lf
    • Add the file to ./

Build

docker build -t ring-gdrive .

Deploy

docker run --env-file credentials.env -d ring-gdrive

This will return the container ID. Run the following to start an interactive terminal.

docker exec -it <container_id> tmux attach

A Google Sign In link will appear. Copy and paste the link on a browser to sign in with your Google account. After allowing the necessary permissions, copy and paste the verification code into the terminal and press enter.

Now exit the terminal by holding down the ctrl+b key and pressing the d key.