{"id":14977963,"url":"https://github.com/kalfasyan/home_surveillance_with_python","last_synced_at":"2025-07-18T20:35:52.809Z","repository":{"id":37595181,"uuid":"152953099","full_name":"kalfasyan/Home_Surveillance_with_Python","owner":"kalfasyan","description":"Motion detection using OpenCV (Raspberry Pi compatible), alerting through pushbullet, served with flask.","archived":false,"fork":false,"pushed_at":"2024-08-30T23:42:59.000Z","size":81,"stargazers_count":10,"open_issues_count":2,"forks_count":5,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-02-05T07:48:08.116Z","etag":null,"topics":["camera","computer-vision","flask-stream","motion-detection","pushbullet-api","pushbullet-notifications","python3","raspberry-pi-camera","security-system","surveillance-systems"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kalfasyan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-10-14T08:16:03.000Z","updated_at":"2024-11-12T02:06:47.000Z","dependencies_parsed_at":"2024-04-16T11:36:45.773Z","dependency_job_id":"d0df62d4-2d19-4daf-8b60-10e815246836","html_url":"https://github.com/kalfasyan/Home_Surveillance_with_Python","commit_stats":{"total_commits":55,"total_committers":2,"mean_commits":27.5,"dds":"0.23636363636363633","last_synced_commit":"35e6875384a6690a34330eb882dc657d0adcddfd"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kalfasyan%2FHome_Surveillance_with_Python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kalfasyan%2FHome_Surveillance_with_Python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kalfasyan%2FHome_Surveillance_with_Python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kalfasyan%2FHome_Surveillance_with_Python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kalfasyan","download_url":"https://codeload.github.com/kalfasyan/Home_Surveillance_with_Python/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238614400,"owners_count":19501451,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["camera","computer-vision","flask-stream","motion-detection","pushbullet-api","pushbullet-notifications","python3","raspberry-pi-camera","security-system","surveillance-systems"],"created_at":"2024-09-24T13:56:36.684Z","updated_at":"2025-02-13T07:30:54.993Z","avatar_url":"https://github.com/kalfasyan.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Motion Detection, Alerts, Streaming  \nWith this repo you can:  \n1. Watch your webcam/camera/picamera feed on localhost [(0.0.0.0:5000)](https://0.0.0.0:5000) which is served with flask.  \n2. Perform motion detection on the camera feed, using opencv.  \n3. Send alerts / push notifications (via pushbullet) to your phone, desktop or anywhere you have installed pushbullet, with its API.  \n4. Save the images that triggered the alerts on your disk (marking the exact image region of movement).  \n  \n\n## Requirements  \nI strongly advise you to install a separate virtual environment to avoid dependency hells of python packages.  \nCheck out \"Step 8\" from [this nice blog post](https://www.pyimagesearch.com/2015/06/22/install-opencv-3-0-and-python-2-7-on-ubuntu/).  \n\nGet an Access token from [Pushbullet](https://www.pushbullet.com/#settings/account)  \n\nMake sure you have 'curl' installed:  \n```sudo apt install curl```  \n  \nPython 3  \n\n## Installation  \nrun the install.sh script:  \n```./install.sh```  \n\n## Usage  \n```CAMERA=opencv python3 app.py -c conf.json```  \n  \nThen open this [address (http://0.0.0.0:5000/)](http://0.0.0.0:5000/) on your browser.  \n  \nIf you run it on raspberry pi (+ enabled camera module, installed picamera package), uncomment line 13 from app.py:  \n```#from camera_pi import Camera```  \nand then run:  \n```python3 app.py -c conf.json```  \n\n### Thanks to:\n[miguelgrinberg](https://github.com/miguelgrinberg/flask-video-streaming) - for the flask streaming part  \n[Adrian Rosebrock](https://www.pyimagesearch.com/2015/06/01/home-surveillance-and-motion-detection-with-the-raspberry-pi-python-and-opencv/) - for the motion detection part  \n[pushbullet](https://docs.pushbullet.com) - for the alerts part  \n\n#### Troubleshooting\nYou might have to install these libraries if you get errors complaining about them:\n```\nsudo apt install libhdf5-dev\nsudo apt install libhdf5-serial-dev \nsudo apt install libqt4-test \nsudo apt install libqtgui4\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkalfasyan%2Fhome_surveillance_with_python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkalfasyan%2Fhome_surveillance_with_python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkalfasyan%2Fhome_surveillance_with_python/lists"}