{"id":13936428,"url":"https://github.com/gaborvecsei/Color-Tracker","last_synced_at":"2025-07-19T22:30:27.666Z","repository":{"id":62563728,"uuid":"101786270","full_name":"gaborvecsei/Color-Tracker","owner":"gaborvecsei","description":"Color tracking with OpenCV","archived":false,"fork":false,"pushed_at":"2020-10-22T18:29:50.000Z","size":68366,"stargazers_count":167,"open_issues_count":2,"forks_count":35,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-11-17T12:09:31.231Z","etag":null,"topics":["color-detection","color-tracker","computer-vision","hacktoberfest","hactoberfest2020","hsv","image-processing","machine-learning","multi-object-tracking","numpy","object-detection","object-tracking","opencv","opencv-python","python","tracker"],"latest_commit_sha":null,"homepage":"","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/gaborvecsei.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}},"created_at":"2017-08-29T17:07:04.000Z","updated_at":"2024-10-17T10:32:00.000Z","dependencies_parsed_at":"2022-11-03T16:00:26.594Z","dependency_job_id":null,"html_url":"https://github.com/gaborvecsei/Color-Tracker","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaborvecsei%2FColor-Tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaborvecsei%2FColor-Tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaborvecsei%2FColor-Tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaborvecsei%2FColor-Tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gaborvecsei","download_url":"https://codeload.github.com/gaborvecsei/Color-Tracker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226686718,"owners_count":17666928,"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":["color-detection","color-tracker","computer-vision","hacktoberfest","hactoberfest2020","hsv","image-processing","machine-learning","multi-object-tracking","numpy","object-detection","object-tracking","opencv","opencv-python","python","tracker"],"created_at":"2024-08-07T23:02:39.848Z","updated_at":"2024-11-27T04:31:02.530Z","avatar_url":"https://github.com/gaborvecsei.png","language":"Python","readme":"[![Codacy Badge](https://api.codacy.com/project/badge/Grade/67f0a9e168b3457385f2f7fcd09a9afa)](https://www.codacy.com/app/vecseigabor.x/Color-Tracker?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=gaborvecsei/Color-Tracker\u0026amp;utm_campaign=Badge_Grade)\n[![PyPI version](https://badge.fury.io/py/color-tracker.svg)](https://badge.fury.io/py/color-tracker)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3](https://img.shields.io/badge/Python-3-brightgreen.svg)](https://www.python.org/downloads/)\n[![DOI](https://zenodo.org/badge/101786270.svg)](https://zenodo.org/badge/latestdoi/101786270)\n\n\n# Color Tracker - Multi Object Tracker\n\nEasy to use **multi object tracking** package based on colors :art:\n\n\u003cimg src=\"art/yellow_cruiser.gif\" width=\"400\" alt=\"yellow-cruiser\"\u003e\u003c/a\u003e \u003cimg src=\"art/ball_tracking.gif\" width=\"400\" alt=\"ball-tracking\"\u003e\u003c/a\u003e\n\n## Install\n\n```\npip install color-tracker\n```\n\n```\npip install git+https://github.com/gaborvecsei/Color-Tracker.git\n```\n\n## Object Tracker\n\n- Check out the **[examples folder](examples)**, or go straight to the **[sample tracking app](examples/tracking.py)** which is an extended version of the script below.\nThis script tracks the red-ish objects, if you'd like to track another color, then start with the `hsv_color_detector.py` script \n    ``` python\n    $ python examples/tracking.py --help\n  \n  \n    usage: tracking.py [-h] [-low LOW LOW LOW] [-high HIGH HIGH HIGH]\n                   [-c CONTOUR_AREA] [-v]\n\n    optional arguments:\n      -h, --help            show this help message and exit\n      -low LOW LOW LOW, --low LOW LOW LOW\n                            Lower value for the HSV range. Default = 155, 103, 82\n      -high HIGH HIGH HIGH, --high HIGH HIGH HIGH\n                            Higher value for the HSV range. Default = 178, 255,\n                            255\n      -c CONTOUR_AREA, --contour-area CONTOUR_AREA\n                            Minimum object contour area. This controls how small\n                            objects should be detected. Default = 2500\n      -v, --verbose\n    ```\n- Simple script:\n\n    ``` python\n    import cv2\n    import color_tracker\n\n\n    def tracker_callback(t: color_tracker.ColorTracker):\n        cv2.imshow(\"debug\", t.debug_frame)\n        cv2.waitKey(1)\n\n\n    tracker = color_tracker.ColorTracker(max_nb_of_objects=1, max_nb_of_points=20, debug=True)\n    tracker.set_tracking_callback(tracker_callback)\n\n    with color_tracker.WebCamera() as cam:\n        # Define your custom Lower and Upper HSV values\n        tracker.track(cam, [155, 103, 82], [178, 255, 255], max_skipped_frames=24)\n    ```\n\n## Color Range Detection\n\nThis is a tool which you can use to easily determine the necessary *HSV* color values and kernel sizes for you app\n\nYou can find **[the HSV Color Detector code here](examples/hsv_color_detector.py)**\n\n``` python\npython examples/hsv_color_detector.py\n```\n\n## Donate :coffee:\n\nIf you feel like it is a **useful package** and it **saved you time and effor**, then you can donate a coffe for me, so I can keep on staying awake for days :smiley: \n\n\u003ca href='https://ko-fi.com/A0A5KN4E' target='_blank'\u003e\u003cimg height='36' style='border:0px;height:36px;' src='https://az743702.vo.msecnd.net/cdn/kofi5.png?v=0' border='0' alt='Buy Me a Coffee at ko-fi.com' /\u003e\u003c/a\u003e\n\n## About\n\nGábor Vecsei\n\n- [Website](https://gaborvecsei.com)\n- [Personal Blog](https://gaborvecsei.com)\n- [LinkedIn](https://www.linkedin.com/in/gaborvecsei)\n- [Twitter](https://twitter.com/GAwesomeBE)\n- [Github](https://github.com/gaborvecsei)\n\n```\n@misc{vecsei2018colortracker,\n      doi = {10.5281/ZENODO.4097717},\n      howpublished={\\url{https://github.com/gaborvecsei/Color-Tracker}},\n      author = {Gabor Vecsei},\n      title = {Color Tracker - Multi Object Tracker},\n      year = {2018},\n      copyright = {MIT License}\n}\n```\n","funding_links":["https://ko-fi.com/A0A5KN4E'"],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgaborvecsei%2FColor-Tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgaborvecsei%2FColor-Tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgaborvecsei%2FColor-Tracker/lists"}