{"id":16556244,"url":"https://github.com/nathancy/opencv-fedex-detector","last_synced_at":"2026-04-19T11:35:11.759Z","repository":{"id":139600102,"uuid":"150186235","full_name":"nathancy/openCV-Fedex-Detector","owner":"nathancy","description":"Real-time Fedex Detector using OpenCV Color Thresholding and Contour Detection through an IP camera stream","archived":false,"fork":false,"pushed_at":"2019-04-02T02:48:41.000Z","size":49039,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-15T07:27:37.341Z","etag":null,"topics":["contour-detection","fedex-detector","ip-camera-frames","opencv","opencv-color-thresholding","opencv-python"],"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/nathancy.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2018-09-25T00:40:13.000Z","updated_at":"2019-07-04T17:17:57.000Z","dependencies_parsed_at":null,"dependency_job_id":"c610d34a-aede-441c-9319-05eb9e31bb63","html_url":"https://github.com/nathancy/openCV-Fedex-Detector","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nathancy%2FopenCV-Fedex-Detector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nathancy%2FopenCV-Fedex-Detector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nathancy%2FopenCV-Fedex-Detector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nathancy%2FopenCV-Fedex-Detector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nathancy","download_url":"https://codeload.github.com/nathancy/openCV-Fedex-Detector/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241928951,"owners_count":20043908,"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":["contour-detection","fedex-detector","ip-camera-frames","opencv","opencv-color-thresholding","opencv-python"],"created_at":"2024-10-11T20:03:57.094Z","updated_at":"2026-04-19T11:35:06.684Z","avatar_url":"https://github.com/nathancy.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# openCV-Fedex-Detector\n\nIP Camera OpenCV Fedex detector. Uses raw OpenCV, no deep learning or trained neural networks. Mainly uses color thresholding and contour detection. \n## Example Detection\nIP Camera Frame\n![](image_detector/photos/example1.PNG)\n\n![](image_detector/photos/example2.PNG)\n\n## Dependencies\n```\npip install python-opencv\npip install numpy\npip install playsound\npip install imutils\n```\n\n## Overall Algorithm \n```\nGet camera IP address\nInitialize IP camera stream, color thresholds, start subprocess camera frame grabber\nWhile camera is open\n    Grab frame\n    Find bounding box for purple\n    Find bounding box for red/orange\n    If both bounding boxes are valid\n        If boxes are adjacent relative to their proximity \n            If contours pass false positive checks\n                Combine bounding boxes\n                Write bounding box on original frame\n                Play sound notificaiton\n                Save image on disk\n        Else show original frame\n    Else show original frame\n```\n\n## Bounding Box Algorithm\n```\nTransform BGR lower and upper color thresholds into np.arrays\nGaussian blur the frame\nCreate a kernel 2D matrix\nUse kernel to erode frame\nUse kernel to dilate frame\nConvert BGR to HSV\nCreate a mask\nFind all contours in the mask\nFind largest contour and obtain bounding rectangle coordinates\nReturn x,y,w,h,cX,cY,and largest contour\n```\n\n## Example Usage\n### fedex_detector.py\nScript to capture real-time IP camera frames and detect Fedex using OpenCV color thresholding and contour detection.\n```\npython fedex_detector.py -s \u003cip_camera #\u003e\n```\n\n## Utility Scripts\n### fedex_single_detector.py\nScript to detect Fedex with a given image from disk using OpenCV color thresholding and contour detection.\n```\npython fedex_single_detector.py \n```\n\n### gimptoHSV.py\nConvert Gimp HSV values into OpenCV HSV values \n```\npython gimptoHSV.py \n```\n\n### HSV_color_detection.py\nHSV color threshold calibration tool \n```\npython HSV_color_detection.py \n```\n\n### people_detector.py\nCreate bounding boxes around people\n```\npython people_detector.py\n```\n\n### sharpness.py\nBlur detection using the variance of Laplacian method to give a floating point value to represent the 'blurryness' of an image. Convolve the input image with the Laplacian operator and compute the variance. If the variance falls below a threshold, mark the image as blurry.\n```\npython sharpness.py\n```\n\n### sharpness_camera.py\nBlur detection of real-time IP camera frames using the variance of Laplacian method to give a floating point value to represent the 'blurryness' of an image. Convolve the input image with the Laplacian operator and compute the variance. If the variance falls below a threshold, mark the image as blurry.\n```\npython sharpness_camera.py\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnathancy%2Fopencv-fedex-detector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnathancy%2Fopencv-fedex-detector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnathancy%2Fopencv-fedex-detector/lists"}