{"id":19589822,"url":"https://github.com/97k/eye","last_synced_at":"2025-07-10T06:10:44.925Z","repository":{"id":224896649,"uuid":"225903684","full_name":"97k/Eye","owner":"97k","description":"Track eye pupil movement, detects blinking of an eye from videos taken from medical devices in which only eye is visible","archived":false,"fork":false,"pushed_at":"2020-01-26T14:05:37.000Z","size":33050,"stargazers_count":18,"open_issues_count":0,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-05T00:36:50.266Z","etag":null,"topics":["blink-detection-algorithm","computer-vision","detection","eye-tracking","image-processing","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":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/97k.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}},"created_at":"2019-12-04T15:54:36.000Z","updated_at":"2025-03-05T13:46:59.000Z","dependencies_parsed_at":"2024-02-28T09:54:03.113Z","dependency_job_id":null,"html_url":"https://github.com/97k/Eye","commit_stats":null,"previous_names":["97k/eye"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/97k%2FEye","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/97k%2FEye/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/97k%2FEye/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/97k%2FEye/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/97k","download_url":"https://codeload.github.com/97k/Eye/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251138934,"owners_count":21541976,"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":["blink-detection-algorithm","computer-vision","detection","eye-tracking","image-processing","opencv","python"],"created_at":"2024-11-11T08:21:34.428Z","updated_at":"2025-04-27T12:33:09.046Z","avatar_url":"https://github.com/97k.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Eye\n\nTracks the eye pupil's movement and effectively detects the blinking of eye. Blinking of eye can be easily detected when eye(facial) landmarks are available, Eye is a computer vision application which can effectively tracks the pupil and find the eye blinking based on heuristics powered by data.\n\n## Instructions to Run\n\nClone the project\n```sh\n$ git clone https://github.com/aditya98ak/Eye.git\n```\n\nInstall the dependencies, [create a virtual environment (recommended)](https://uoa-eresearch.github.io/eresearch-cookbook/recipe/2014/11/26/python-virtual-env/)\n```sh\n$ cd Eye\n$ pip install -r requirements.txt\n```\n## Run the application\n\n```sh\n$ python main.py\n```\nI've added a video file in order to show how it works. As of now, this application works on closely cropped eye videos stacked side by side (horizontally). The aim of this application is to apply heuristics to find blinking of the eye in case where eye(facial) landmarks are not available or can not be generated. This is just a POC and it's performace can definately be improved!\n\n## Final Result\n\n![eye](https://user-images.githubusercontent.com/21143936/73135248-04d2ff00-4066-11ea-9c28-c4d369479ba7.gif)\n\n## Screenshots\n\n1.  Sample frame\n![image](https://user-images.githubusercontent.com/21143936/73131590-c7ee1480-4033-11ea-90bb-c859d108b3be.png)\n2.  Detection of pupil\n![image](https://user-images.githubusercontent.com/21143936/73131548-f7e8e800-4032-11ea-868d-dfca3cfe20e3.png)\n3.  Detection of blink\n![image](https://user-images.githubusercontent.com/21143936/73131577-852c3c80-4033-11ea-95b3-52d68bf3fd0f.png)\n4. SSIM Difference\n![image](https://user-images.githubusercontent.com/21143936/73131600-18657200-4034-11ea-85f1-57726f04e3e0.png)\n\nThis approach can be helpful in cases where data is obtained from devices in healthcare domain and we may still need to track, capture blink of eye and not whole face is visible. If whole face is visible, then eye blink can be easily detected with help of (eye) facial landmarks!\n\n## Contributing\n\nAll patches welcome!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F97k%2Feye","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F97k%2Feye","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F97k%2Feye/lists"}