{"id":27070437,"url":"https://github.com/kirienko/vri-scores","last_synced_at":"2025-04-05T22:35:22.390Z","repository":{"id":284053686,"uuid":"943974450","full_name":"kirienko/vri-scores","owner":"kirienko","description":"A tool to quickly extract Virtual Regatta Inshore race results from screenshots","archived":false,"fork":false,"pushed_at":"2025-04-03T20:26:47.000Z","size":142,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-03T21:29:12.235Z","etag":null,"topics":["discord-bot","discord-py","tesseract","vibe-coding","virtual-regatta"],"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/kirienko.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":"2025-03-06T15:19:21.000Z","updated_at":"2025-04-03T20:26:50.000Z","dependencies_parsed_at":"2025-03-23T22:34:58.959Z","dependency_job_id":"4b112001-53e7-4779-8e85-8e7f5c6b2144","html_url":"https://github.com/kirienko/vri-scores","commit_stats":null,"previous_names":["kirienko/vri-scores"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kirienko%2Fvri-scores","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kirienko%2Fvri-scores/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kirienko%2Fvri-scores/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kirienko%2Fvri-scores/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kirienko","download_url":"https://codeload.github.com/kirienko/vri-scores/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247411253,"owners_count":20934650,"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":["discord-bot","discord-py","tesseract","vibe-coding","virtual-regatta"],"created_at":"2025-04-05T22:35:21.981Z","updated_at":"2025-04-05T22:35:22.382Z","avatar_url":"https://github.com/kirienko.png","language":"Python","funding_links":["https://www.buymeacoffee.com/kirienko"],"categories":[],"sub_categories":[],"readme":"# vri-scores\nA tool to quickly extract Virtual Regatta Inshore race results from screenshots\n\n## Features\n\n- **Screenshot OCR:** Automatically extracts race results from screenshots using [Tesseract OCR](https://github.com/tesseract-ocr/tesseract).\n- **Text Ranking Parsing:** Supports direct text input with \"Ranking:\" followed by a list of names.\n- **Race Combination:** Combines multiple screenshots in the same message into one race.\n- **Emoji Reactions:** Uses number emojis (e.g., 1️⃣, 2️⃣) to label races.\n- **Total Score Calculation:** Aggregates scores across races, handling `DSQ`, `DNF`, and `DNS`. \n  Low point scoring system (see the Rule `A4`).\n- **Reset Command:** Type `!reset` to clear the stored race table.\n- **Fast and Responsive:** Fast extraction of race results with a final aggregated table display upon request.\n\n### Example of ranking from a screenshot: \n![](ranking.png)\n\n⬆️ As you may notice, the recognition was not ideal in the example above.\nThis is the reality of fast and cheap OCR.\n\n### Example of a race table after three races:\n![](race_table.png)\n\n### Not supported (yet)\n- medal races\n- worst race[s] exclusion\n- non-integer scores\n- series ties according to the `A8` Rule\n\n## Installation\n```\npip install -r requirements.txt\nsudo apt-get install tesseract-ocr  # apt-based Linux\nbrew install tesseract              # macOS\n```\n\nYou also need the `fonts-noto-cjk` font.\n\n## Deployment\n\n### Bare Metal\n\nTo run on bare metal, simply run:\n```bash\npython main.py\n```\nEnsure that Tesseract and required system dependencies are installed as per the [Installation](#installation) instructions.\n\n### Docker\n\nTo run using Docker, use the provided `Dockerfile` and `docker-compose.yml`:\n```bash\ndocker-compose up --build\n```\nThis command builds the Docker image and starts the container.\n\n## Support\nNow you can buy me a coffee to encourage further development!\n\n[![\"Buy Me A Coffee\"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/kirienko)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkirienko%2Fvri-scores","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkirienko%2Fvri-scores","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkirienko%2Fvri-scores/lists"}