Skip to content

mmione/little-brother-security-system

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📷 little brother 📷

A non-intrusive, not scary, open source, and simple home-monitoring solution.

Turn an old phone 📱 into something useful again using Python and OpenCV.

The team

Pictured above is the team, captured intelligently by the app!

Devpost link

What do I need?

  • Old phone (Android or IOS based)
    • DroidCam or any other IP camera software
  • A host machine with at least a dual-core CPU to run the application.
  • A local area network (you don't even need internet access, just the router)
  • A Gmail account from which you want to send emails

Installation

python -m pip install -r requirements.txt

How to use

Necessary Configuration

Specific things such as the email to send info to, etc. should be specified in the root of the cloned repository, in a YAML file named config.yml. An example is shown below:

email: example@gmail.com            # email that you want information sent to by the application
ip: 192.168.0.122:4747              # IP address (with port) of the IP cam instance
framerate: 10                       # Framerate of the exported video
sender: examplesender@gmail.com     # Email you are using to send notifications

Next, make sure you configure your gmail account from which you want to send emails. I recommend creating a throwaway account quickly to serve as your email for this project. Then, go ahead and toggle the following setting to on as seen in the attached image:

google settings

This can also be found by clicking here! Google warns there is a security risk by doing this, so make sure you have a strong password and that this account is not an important one to you.

Running the App

After the above configuration has been completed, simply run in this in the root of the cloned repository.

python main.py

References

This project uses openCV's Histogram of Oriented Gradients method to detect humans in its field of view. This paper goes into detail on HOG: https://lear.inrialpes.fr/people/triggs/pubs/Dalal-cvpr05.pdf

Releases

No releases published

Packages

No packages published

Languages