{"id":25973057,"url":"https://github.com/scoville/dryeye-defender-public","last_synced_at":"2026-07-02T15:01:42.780Z","repository":{"id":280272542,"uuid":"890452422","full_name":"scoville/dryeye-defender-public","owner":"scoville","description":"Blink Detection Software to Improve Eye Health","archived":false,"fork":false,"pushed_at":"2025-03-02T11:50:21.000Z","size":12293,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"develop","last_synced_at":"2025-11-21T11:12:16.971Z","etag":null,"topics":["blepharitis","blink","blink-detection","blink-detection-algorithm","dry-eye-disease","eye-health","eye-tracking","jenkins-enabled","webcam-capture"],"latest_commit_sha":null,"homepage":"https://dryeye-defender.sc0ville.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/scoville.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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,"publiccode":null,"codemeta":null}},"created_at":"2024-11-18T15:37:38.000Z","updated_at":"2025-07-17T11:28:24.000Z","dependencies_parsed_at":"2025-03-02T12:41:30.535Z","dependency_job_id":null,"html_url":"https://github.com/scoville/dryeye-defender-public","commit_stats":null,"previous_names":["scoville/dryeye-defender-public"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/scoville/dryeye-defender-public","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scoville%2Fdryeye-defender-public","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scoville%2Fdryeye-defender-public/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scoville%2Fdryeye-defender-public/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scoville%2Fdryeye-defender-public/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/scoville","download_url":"https://codeload.github.com/scoville/dryeye-defender-public/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scoville%2Fdryeye-defender-public/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35051884,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-02T02:00:06.368Z","response_time":173,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["blepharitis","blink","blink-detection","blink-detection-algorithm","dry-eye-disease","eye-health","eye-tracking","jenkins-enabled","webcam-capture"],"created_at":"2025-03-05T01:18:54.582Z","updated_at":"2026-07-02T15:01:42.278Z","avatar_url":"https://github.com/scoville.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DryEye Defender 👁️\n\n\u003cimg src=\"assets/Logo.png\" width=\"800\" alt=\"Scoville Logo\"\u003e\n\nProtect your eye health with smart blink detection and reminders. DryEye Defender is an open-source application that helps prevent digital eye strain and dry eye syndrome.\n\n## How does it work?\n\nDryEye Defender takes advantage of the latest advancements in Computer Vision and AI to analyse your face for the eyelid position and uses that to measure the extent of your blink over time. If it detects blinks have not occurred for a sufficient duration (configurable by you), you’ll be notified by a system tray notification, a sound notification, or a blink animation - you can personalise the best notification method for you.\n\n![demo](docs/demo.gif)\n![demo.png](docs/demo.png)\n\n## ✨ Key Features\n\n- 🎯 **Real-time Blink Detection**: Advanced facial keypoint tracking powered by MediaPipe's face mesh detection\n- 📊 **Personal Analytics**: Track your blink rate over time with detailed statistics and visualizations\n- 🔔 **Smart Reminders**: Customizable notifications when you're not blinking enough\n- 🔒 **Privacy First**: All processing happens locally - no data leaves your device\n- 💻 **Cross Platform**: Supports Windows, macOS, and Linux\n- 📱 **System Tray Integration**: Runs quietly in the background while protecting your eyes\n\n## 🔬 Science Behind DryEye Defender\n\n- 🔊 Sound Design: Our notification tone (800Hz, 190ms) is scientifically calibrated to optimize blink response [[1](https://link.springer.com/article/10.1007/s00347-004-1072-7)]\n\n- 👁️ Visual Reminders: Animated blink reminders have been proven to increase blink rates by up to 139% in clinical studies [[2](http://www.blinknow.co.uk/index.php?act=viewDoc\u0026docId=11)][[3](https://pubmed.ncbi.nlm.nih.gov/26164310/)]\n\n- ⚖️ Validated Fairness: Our facial detection models are tested across faces from 17 regions [[4](https://drive.google.com/file/d/1QvwWNfFoweGVjsXF3DXzcrCnz-mx-Lha/preview)]\n\n## 🚀 Quick Start\n\n### Download\n\nGet the latest version for your platform:\n- [Windows Installer](https://github.com/scoville/dryeye-defender-public/releases/download/1.0.3/dryeye_defender-1.0.3-win64.msi)\n- [macOS App](https://github.com/scoville/dryeye-defender-public/releases/download/1.0.3/dryeye_defender_1.0.3.zip)\n  - You may get an error that the app is unsigned. To force the opening you can follow [these instructions](https://support.apple.com/en-gb/guide/mac-help/mh40616/mac)\n- [Linux Package](https://github.com/scoville/dryeye-defender-public/releases/download/1.0.3/dryeye_defender_1.0.3_all.deb)\n\n### Usage\n\n1. Install and launch DryEye Defender\n2. Grant camera permissions when prompted\n3. The app will run in your system tray, monitoring your blink rate\n4. Customize reminder settings and view your blink statistics from the main interface\n\nFor detailed setup instructions and advanced configuration, see our [Installation Guide](docs/installation.md).\n\n## 🤝 Contributing\n\nWe have limited resources for this project so please understand that we may not be able to review contributions promptly but they are welcome nonetheless:\n\nSee our [Contributing Guide](CONTRIBUTING.md) for more details.\n\nOtherwise, we encourage you to build off this framework and create your own blink detection software with attribution to this project.\n\n## 📚 Learn More\n\n- [How Blinking Keeps Your Eyes Healthy](https://dryeye-defender.sc0ville.com/how-does-blinking-keep-my-eye-healthy)\n- [Why Blink Rate Matters](https://dryeye-defender.sc0ville.com/why-should-i-care-about-blink-rate)\n- [How DryEye Defender Works](https://dryeye-defender.sc0ville.com/how-does-the-dryeye-defender-software-work)\n\n## 🏢 About Us\n\nDryEye Defender is developed and maintained by [Scoville Inc.](https://scoville.jp), a leading provider of digital technology consulting and product solutions. We specialize in developing innovative solutions that make a difference in people's lives.\n\n## 📄 License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details. This license allows you to freely use, modify, and distribute this software, while ensuring proper attribution:\n\n- You must include appropriate attribution notices\n- You must document any significant modifications you make\n- You must retain all copyright, patent, trademark, and attribution notices\n- You receive patent usage rights\n- You can use the code commercially and make closed-source modifications\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://scoville.jp\"\u003e\n    Built by Scoville Ltd. 🌶\n  \u003c/a\u003e\n  \u003cbr/\u003e\n  \u003ca href=\"https://scoville.jp\"\u003e\n    \u003cimg src=\"docs/scoville-logo.svg\" width=\"200\" alt=\"Scoville Logo\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscoville%2Fdryeye-defender-public","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscoville%2Fdryeye-defender-public","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscoville%2Fdryeye-defender-public/lists"}