{"id":15060938,"url":"https://github.com/avestura/eyesguard","last_synced_at":"2025-04-05T17:07:32.400Z","repository":{"id":43343301,"uuid":"92981622","full_name":"avestura/EyesGuard","owner":"avestura","description":"👀 Windows Application for protecting your eyes","archived":false,"fork":false,"pushed_at":"2024-02-07T23:35:01.000Z","size":5022,"stargazers_count":329,"open_issues_count":22,"forks_count":37,"subscribers_count":11,"default_branch":"master","last_synced_at":"2024-05-19T10:10:45.023Z","etag":null,"topics":["break","csharp","eye-care","eye-protection","eyes","eyes-guard","eyesight","fsharp","health","healthcare","protection","utilities","utility-application","uwp","wpf"],"latest_commit_sha":null,"homepage":"https://github.avestura.dev/EyesGuard","language":"C#","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/avestura.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,"publiccode":null,"codemeta":null}},"created_at":"2017-05-31T19:33:08.000Z","updated_at":"2024-05-27T18:59:29.200Z","dependencies_parsed_at":"2024-01-13T15:37:47.249Z","dependency_job_id":"18916e08-0f26-418b-bd9f-ed337d14c898","html_url":"https://github.com/avestura/EyesGuard","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avestura%2FEyesGuard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avestura%2FEyesGuard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avestura%2FEyesGuard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avestura%2FEyesGuard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/avestura","download_url":"https://codeload.github.com/avestura/EyesGuard/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247369952,"owners_count":20927928,"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":["break","csharp","eye-care","eye-protection","eyes","eyes-guard","eyesight","fsharp","health","healthcare","protection","utilities","utility-application","uwp","wpf"],"created_at":"2024-09-24T23:06:59.953Z","updated_at":"2025-04-05T17:07:32.374Z","avatar_url":"https://github.com/avestura.png","language":"C#","funding_links":["https://ko-fi.com/P5P011XLE"],"categories":[],"sub_categories":[],"readme":"# Eyes Guard \u003cimg align=\"left\" width=\"120\" height=\"120\" src=\"UWPAssets/150x150.png\"\u003e\n\n[![BuitlWithDot.Net shield](https://builtwithdot.net/project/41/eyes-guard/badge)](https://builtwithdot.net/project/41/eyes-guard)\n![platform](https://img.shields.io/badge/platform-UWP%20%7C%20Win32-blue)\n[![Build status](https://github.com/avestura/EyesGuard/actions/workflows/ci.yml/badge.svg)](https://github.com/avestura/EyesGuard/actions/workflows/ci.yml)\n[![Build status](https://github.com/avestura/EyesGuard/actions/workflows/cd.yml/badge.svg)](https://github.com/avestura/EyesGuard/actions/workflows/cd.yml)\n\n\n\u003cbr\u003e\n\n## What is Eyes Guard?\nEyes Guard is a Windows Application for protecting your eyes. It will help you (also can force you!) to break if you are working with your PC for a long time using configurable times.\n\n## Download\n\n### Windows 10/11 (Official with latest features)\n\n\u003e [!NOTE]  \n\u003e EyesGuard will no longer distribute its packages via Microsoft Store. You need to install the \n\u003e package manually using the instruction below:\n\n#### 📦 Method 1: Use the command-line WinGet tool (recommended):\n\nUse WinGet command-line tool:\n\n```powershell\nwinget install -s winget Avestura.EyesGuard\n```\n\n#### 📦 Method 2: Use the graphical setup (recommended):\n\n1. [🟩 Download the latest setup form the Releases section](https://github.com/avestura/EyesGuard/releases). \n   - For x64 systems: `EyesGuard-Setup-VERSION-x64.exe`\n   - For x86 systems: `EyesGuard-Setup-VERSION-x86.exe`\n2. Run the setup and install EyesGuard.\n\n#### 🪟 Method 3: Use Windows Store Package (needs Developer mode to be enabled):\n\n1. Enable Developer Mode from `Settings \u003e System \u003e For Developers`\n2. [🟩 Download the latest package form the Releases section](https://github.com/avestura/EyesGuard/releases). \n   - For x64 systems: `EyesGuard.release.x64.zip`\n   - For x86 systems: `EyesGuard.release.x86.zip`\n3. Unzip the package.\n4. Find the certificate file with `.cer` extension and open it.\n5. Click `Install Certificate` \u003e `Local Machine` \u003e `Place certificate in following store` \u003e pick `Trusted People`\n6. Open the installation package with `.appx` extension and install Eyes Guard.\n\n### Windows 7 (Unofficial Fork, not latest)\n\n[Download from ExplorerOL's GitHub](https://github.com/ExplorerOL/AryanSoftware_EyesGuard/releases/tag/AryanSoftware_EyesGuard_Release_2020_01_14)\n\n## Any Screenshots?\n\n#### Control Panel\n![Eyes Guard](Screenshots/Store/main.JPG)\n#### Settings\n![Eyes Guard Settings](Screenshots/Store/Settings.PNG)\n#### Notify Icon\n![Eyes Guard NotifyIcon](Screenshots/Store/ContextMenu.png)\n\n---\n\n## What features does it have?\n\n| Feature                  | Implementation State | Is live on store version? |\n|--------------------------|----------------------|---------------------------|\n| Short Break              | ✔ Implemented        | ✔ Yes                    |\n| Long Break               | ✔ Implemented        | ✔ Yes                    |\n| Timing Customization     | ✔ Implemented        | ✔ Yes                    |\n| Stas                     | ✔ Implemented        | ✔ Yes                    |\n| Pause or Stop protection | ✔ Implemented        | ✔ Yes                    |\n| Windows Tray Integration | ✔ Implemented        | ✔ Yes                    |\n| Auto Start               | ✔ Implemented        | ✔ Yes                    |\n| Customize messages       | ✔ Implemented        | ✔ Yes                    |\n| Multi-language           | ✔ Implemented        | ✔ Yes                    |\n\n## How can I help?\n\nEyes Guard is a free and open-source app. If you like it, please consider:\n\n- ⭐ Star this project in GitHub\n- [![ko-fi](https://www.ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/P5P011XLE)\n- 👩‍💻 Contribute to Software Development of Eyes Guard\n- ✏ Translate app to your language using guide below\n\n## Supported Languages\n\n| |Language|Locale|Translator|\n|-|--------|------|----------|\n|[![us][us]](#)|English|en-US|[Aryan Ebrahimpour](https://avestura.dev), [Gianpaolo Filippa](https://github.com/gianpaolof), [Akash Joshi](https://akashj.com)|\n|[![ir][ir]](#)|Persian|fa-IR|[Aryan Ebrahimpour](https://avestura.dev)|\n|[![it][it]](#)|Italian|it-IT|[Gianpaolo Filippa](https://github.com/gianpaolof)|\n|[![fr][fr]](#)|French|fr-FR|[Bouillon Pierre](https://pbouillon.github.io)|\n|[![ru][ru]](#)|Russian|ru-RU|[Dmitry Vorobjev](https://github.com/ExplorerOL)|\n|[![no][no]](#)|Norwegian|nb-NO|[Thomas Rory Gummerson](https://trgwii.no/)|\n|[![in][in]](#)|Tamil|ta-IN|[Muthu Kumar](https://mkr.pw)|\n|[![ko][ko]](#)|Korean|ko-KR|[Sung Jae Cho](https://rubycho.github.io)|\n|[![ch][ch]](#)|Chinese |zh-CN|[Qixiny](https://github.com/qixinynan)|\n|[![tr][tr]](#)|Turkish |tr-TR|[Furkan KARADENİZ](https://github.com/Suqbs)|\n|[![de][de]](#)|German |de-DE|[Marco Heinisch](https://github.com/marcoheinisch)|\n|[![po][po]](#)|Polish |po-PO|[Bartlomiej Szmolke](https://github.com/BSzmolke)|\n|[![ua][ua]](#)|Ukrainian |uk-UA|[Yaroslav Shaposhnyk](https://github.com/masterillaGitHub)|\n|[![gr][gr]](#)|Greek |el-GR|[Alexandros Koulelis](https://github.com/AlexKoulel)|\n|[![add][add]](#how-to-contribute-to-translating-app)|[Add Language](#how-to-contribute-to-translating-app)||You|\n\n[us]: https://img.icons8.com/color/48/000000/usa.png\n[ir]: ./assets/flags/iran.png\n[it]: https://img.icons8.com/color/48/000000/italy.png\n[fr]: https://img.icons8.com/color/48/000000/france.png\n[ru]: https://img.icons8.com/color/48/000000/russian-federation.png\n[no]: https://img.icons8.com/color/48/000000/norway.png\n[in]: https://img.icons8.com/color/48/000000/india.png\n[ko]: https://img.icons8.com/color/48/000000/south-korea.png\n[ch]: https://img.icons8.com/color/48/000000/china.png\n[tr]: https://img.icons8.com/color/48/000000/turkey.png\n[de]: https://img.icons8.com/color/48/000000/germany.png\n[po]: https://img.icons8.com/color/48/000000/poland.png\n[ua]: https://img.icons8.com/color/48/000000/ukraine.png\n[gr]: https://img.icons8.com/color/48/000000/greece.png\n[add]: https://img.icons8.com/doodle/48/000000/add.png\n\n## Can I contribute?\n\nPRs are very welcome!\n\nYou can contribute to software development and/or create translations for the app.\n\n### How to contribute to translating app\n\n#### Method 1 : using GitHub\n\u003chr\u003e\n\nAdding a new Language:\n\n1. Go to [Languages](https://github.com/avestura/EyesGuard/tree/master/Source/EyesGuard.Data/Languages) folder and create a new yaml file with name `{StandardCountryCode}.yml` like `en-US.yml` or `fa-IR.yml`. Here is a [List of country codes](CountryCodes.md) you can pick.\n2. Copy the content of `en-US.yml` to the new created file.\n3. In the meta part of yaml edit the `Translators` array. Remove the existing translators in the copied file and just put information of yourself.\n4. Translate the `Translation` section of file and make a PR!\n\nModifying a translation file:\n\n1. Go to [Languages](https://github.com/avestura/EyesGuard/tree/master/Source/EyesGuard.Data/Languages) and find the language you want to edit using its standard locale.\n2. In the meta part of yaml and in the `Translators` array, add yourself as a new translator without removing others from the list.\n3. Make your changes in the `Translation` section and make a PR!\n\n#### Method 2 : using Email\n\u003chr\u003e\nUse the links mentioned in above method, modify/add translation file, then email it to me: Oxaryan@outlook.com\n\n### 📜 RTL Languages\n\nFor right-to-left languages like Persian, Arabic, etc. It is not needed to explicitly state language layout in the meta section. Simply use a standard country code, and the app automatically detects if it has right-to-left direction or not and changes the design of elements in app.\n\n## 📐 Solution Structure\n\n| Project Name   | Language | Description                                  |\n|----------------|----------|----------------------------------------------|\n| EyesGuard      | C#       | Main Application (at the time of starting project I didn't know F# to write the app entirely in F#)|\n| EyesGuard.Data | F#       | Type Provider and Data Access / Translations |\n| StorePackage   |          | Used to publish WPF app into Store           |\n\n## 🔨 Build\n\nYou need [Paket Package manager for .NET](https://fsprojects.github.io/Paket) to restore the packages.\n\n```powershell\ngit clone https://github.com/avestura/EyesGuard\ncd .\\EyesGuard\npaket install\ncd .\\Source\\EyesGuard\ndotnet run\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favestura%2Feyesguard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Favestura%2Feyesguard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favestura%2Feyesguard/lists"}