{"id":17693490,"url":"https://github.com/amboxer21/imagecapture","last_synced_at":"2025-07-15T10:37:00.004Z","repository":{"id":147837541,"uuid":"100082921","full_name":"amboxer21/ImageCapture","owner":"amboxer21","description":"Grabs location and webcam pic of person entering wrong password, then E-mails both to you.","archived":false,"fork":false,"pushed_at":"2024-04-17T17:51:44.000Z","size":42010,"stargazers_count":2,"open_issues_count":5,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-13T03:47:29.857Z","etag":null,"topics":["image","location","monitor","python","security"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amboxer21.png","metadata":{"files":{"readme":"README.md","changelog":"Changelog","contributing":null,"funding":null,"license":null,"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":"2017-08-12T02:07:07.000Z","updated_at":"2024-08-12T19:31:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"f0932dba-1fe9-4081-999f-44181158ba70","html_url":"https://github.com/amboxer21/ImageCapture","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/amboxer21/ImageCapture","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amboxer21%2FImageCapture","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amboxer21%2FImageCapture/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amboxer21%2FImageCapture/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amboxer21%2FImageCapture/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amboxer21","download_url":"https://codeload.github.com/amboxer21/ImageCapture/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amboxer21%2FImageCapture/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265429106,"owners_count":23763689,"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":["image","location","monitor","python","security"],"created_at":"2024-10-24T13:45:11.253Z","updated_at":"2025-07-15T10:36:59.986Z","avatar_url":"https://github.com/amboxer21.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ImageCapture\n### Description\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;A program that captures an image and the geolocation data of any user that attempts to login to your compuper x amount of times. The data collected by ImageCapture is then E-mailed to the address you specify. This is a work in progress, so if you find any issues or bugs, please create an issue! I would very much appreciate it! PLEASE FORK INSTEAD OF CLONE, I WOULD GREATLY APPRECIATE IT!\n\n### [Details]\n##### Overview:\n\u003cp\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;ImageCapture allows you to take a picture of the offender after the numbers of attempts of failed logins are reached. The number of attempts can be specified when starting the program. You can also grab the devices location in the form of geolocationdata. Both the picture and or the location data can then be E-mailed to you if you'd like. All you would need to do is pass an E-mail address and password to the program when starting it. E-mail credentials are needed because I am not providing an E-mail service so you have to be able to send the information someway - That way is through your own E-mail account. You should be able to see the outgoing E-mails in your sent box.\u003c/p\u003e\n   \nMore to come...\n\n## OPTIONS (Highly configurable)\n\u003eMost options are interchangeable, it's just a matter of what you wish to accomplish!\n\n### [Example use cases]\n1) Capture an image of the offender only and E-mail that picture to yourself.\n\n   ```sudo python imagecapture.py -c -e 'example@gmail.com' -p 'password' -l '/var/log/messages'```\n   \n2) Capture an image of the offender, autolog them in, grab the devices location, and E-mail the resulting info to yourself.\n\n   ```sudo python imagecapture.py -ALc -e 'example@gmail.com' -p 'password' -l '/var/log/messages'```\n\n3) Capture an image of the offender, autolog them in, grab the devices location, specify the auth logs location, specify the browser, specify the camera index, print verbose messages to the log, and E-mail resulting info to yourself.\n\n   ```sudo python imagecapture.py -AL -v -B '/opt/google/chrom/chrome' -e 'example@gmail.com' -p 'password' -l '/var/log/messages'```\n   \n4) Capture an image of the offender, autolog them in, grab the devices location, E-mail the resulting info to yourself, and run the location gathering functionality everytime the computer is booted up.\n\n   ```sudo python imagecapture.py -ALUc -e 'example@gmail.com' -p 'password' -l '/var/log/messages'```\n\n### [Visual of All Options]\n```\n[anthony@ghost ImageCapture]$ sudo python src/imagecapture.py --help\nUsage: imagecapture.py [options]\n\nOptions:\n  -h, --help            show this help message and exit\n  -e EMAIL, --email=EMAIL\n                        E-mail address to send notofications to.\n  -p PASSWORD, --password=PASSWORD\n                        Password used to sign-in to your E-mail account.\n  -V VIDEO, --video=VIDEO\n                        Specify camera location.\n  -v, --verbose         Print the options passed to ImageCapturePy.\n  -P PORT, --port=PORT  E-mail port defaults to 587 if not specified.\n  -a ATTEMPTS, --attempts=ATTEMPTS\n                        Number of failed attempts defaults to 3.\n  -L, --location        Enable location capturing.\n  -U, --persistent-location\n                        Run location capturing routine everytime the computer\n                        is powered on.\n  -l LOGFILE, --log-file=LOGFILE\n                        Log file for program to tail. There is no default and\n                        this option is mandatory!\n  -c, --enable-cam      Enable cam capture of intruder.\n  -A, --auto-login      Auto login user after no of failed attempts.\n  -w WEBSITE, --website=WEBSITE\n                        Use alternate website to capture location.\n  -X, --clear-autologin\n                        Remove autologin. Must be root to use this feature.\n  -s, --allow-sucessful\n                        Run ImageCapture even if login is sucessful.\n  -B BROWSER, --browser=BROWSER\n                        Select the browser used to grab geolocation data.\n  -C CONFIGFILE, --config-file=CONFIGFILE\n                        Configuration file path.\n```\n\n### [ImageCapture's default values]\n      \n   * Browser:\n   \n      ```/opt/google/chrome/chrome```\n      \n   * Website to grab location data:\n   \n      ```https://imagecapturepy.herokuapp.com/index.html```\n\n   * Autologin:\n   \n      ```false```\n      \n   * Capture image of offender:\n   \n      ```false```\n      \n   * Logfile(*):\n   \n      ```There is NO default value  set for this option.```\n      \n   * Loation:\n    \n      ```false```\n    \n   * E-mail port:\n   \n      ```587```\n      \n   * Print options passed(verbose):\n   \n      ```false```\n      \n   * Camera index:\n   \n      ```0```\n      \n   * Password:\n   \n      ```password```\n      \n   * E-mail address:\n   \n      ```example@gmail.com```\n   \n   * Attempt count:\n   \n      ```3```\n      \n\n## IMAGECAPTURE INSTALLATION\n```\nsudo python setup.py sdist \n```\n```\nsudo python setup.py build\n```\n```\nsudo python setup.py install\n```\n\n## IMAGECAPTURE SYSTEM DEPENDENCY CHECK\n```\nsudo python setup.py check\n```\n\n## SYSTEM DEPENDENCIES\n\n### [Debian Based Systems]\n\n* libopencv-dev\n* python-opencv\n* python-dev\n* procmail\n* sendmail-base \n* sendmail-bin\n* sendmail-cf\n* sensible-mda\n* syslog-ng\n* sqlite3\n\n   You can install these packages by running **sudo apt-get install package_name_above**\n\n## IMPORTANT!\nYou must enable less secure apps in your gmail settings or the app will not be able to send notifications!\nhttps://support.google.com/accounts/answer/6010255\n\n# Building a release for PyPi\n\n## Modify version in setup.py via vim/nano before building\n**`BEFORE(vim/nano setup.py):`**\n```javascript\n    setup(\n        packages=[],\n        name='imagecapture',\n        version='0.0.6', # increment version number\n```\n**`AFTER:`**\n```javascript\n    setup(\n        packages=[],\n        name='imagecapture',\n        version='0.0.7', # increment version number\n```\n## Build package for PyPi\n\n**[anthony@ghost ImageCapture]$** `sudo python setup.py sdist`\n  \n**[anthony@ghost ImageCapture]$** `twine upload dist/*`\n  \n**NOTE:** If twine does not work with the above command you can try,\n\n`twine upload --repository-url 'https://upload.pypi.org/legacy/' dist/imagecapture-0.0.6.tar.gz`.\n   \n   \n**NOTE:** `dist/imagecapture-0.0.6.tar.gz` will be the name of the file twine just created.\n\n## Contents of ~/.pypirc\n```javascript\n[distutils]\nindex-servers =\n  pypi\n  pypitest\n[pypi]\nrepository=https://pypi.python.org/pypi\nusername=username\npassword='password'\n[pypitest]\nrepository=https://testpypi.python.org/pypi\nusername=username\npassword='password'\n```\n\n## Building OpenCV with CMake\n```javascript\ncmake -DCAKE_BUILD_TYPE=RELEASE -DCMAKE_INSTALL_PREFIX=/usr/local/opencv-3.4.0 -DWITH_OPENCL=OFF -DWITH_VTK=OFF -DWITH_QT=OFF -DWITH_EIGEN=ON -DWITH_FFMPEG=ON -DWITH_GSTREAMER=ON -DWITH_GTK=OFF -DWITH_JPEG=ON -DWITH_OPENGL=OFF -DWITH_OPENCL=OFF -DWITH_PNG=ON -DWITH_V4L=ON -DWITH_LIBV4L=ON -DWITH_VA=ON -DWITH_GPHOTO2=ON -DINSTALL_PYTHON_EXAMPLES=ON -DBUILD_EXAMPLES=ON -DBUILD_DOCS=ON -DWITH_CUDA=OFF -DWITH_OPENCL_SVM=OFF -DWITH_OPENCLAMDFFT=OFF -DWITH_OPENCLAMDBLAS=OFF -DOPENCV_EXTRA_MODULES_PATH=../opencv_contrib/modules ..\n```\n\u003cp\u003eSteps to obtaining the opencv_contrib package\u003c/p\u003e\n\n- git clone git@github.com:opencv/opencv_contrib.git\n\n- git branch -r | more\n\n\u003cp\u003eExample output:\u003c/p\u003e\n\n```javascript\nanthony@anthony:~/Documents/Source/opencv_contrib$ git branch -r | more\n  origin/3.4\n  origin/HEAD -\u003e origin/master\n  origin/master\nanthony@anthony:~/Documents/Source/opencv_contrib$\n```\n\n- git checkout 3.4\n\n\u003cp\u003eNow the opencv_contrib package is ready to use and include in your `CMAKE` compilation!\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famboxer21%2Fimagecapture","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famboxer21%2Fimagecapture","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famboxer21%2Fimagecapture/lists"}