https://github.com/kirienko/vri-scores
A tool to quickly extract Virtual Regatta Inshore race results from screenshots
https://github.com/kirienko/vri-scores
discord-bot discord-py tesseract vibe-coding virtual-regatta
Last synced: 6 months ago
JSON representation
A tool to quickly extract Virtual Regatta Inshore race results from screenshots
- Host: GitHub
- URL: https://github.com/kirienko/vri-scores
- Owner: kirienko
- License: mit
- Created: 2025-03-06T15:19:21.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-04-03T20:26:47.000Z (6 months ago)
- Last Synced: 2025-04-03T21:29:12.235Z (6 months ago)
- Topics: discord-bot, discord-py, tesseract, vibe-coding, virtual-regatta
- Language: Python
- Homepage:
- Size: 139 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# vri-scores
A tool to quickly extract Virtual Regatta Inshore race results from screenshots
## Features
- **Screenshot OCR:** Automatically extracts race results from screenshots using [Tesseract OCR](https://github.com/tesseract-ocr/tesseract).
- **Text Ranking Parsing:** Supports direct text input with "Ranking:" followed by a list of names.
- **Race Combination:** Combines multiple screenshots in the same message into one race.
- **Emoji Reactions:** Uses number emojis (e.g., 1️⃣, 2️⃣) to label races.
- **Total Score Calculation:** Aggregates scores across races, handling `DSQ`, `DNF`, and `DNS`.
Low point scoring system (see the Rule `A4`).
- **Reset Command:** Type `!reset` to clear the stored race table.
- **Fast and Responsive:** Fast extraction of race results with a final aggregated table display upon request.
### Example of ranking from a screenshot:
⬆️ As you may notice, the recognition was not ideal in the example above.
This is the reality of fast and cheap OCR.
### Example of a race table after three races:
### Not supported (yet)
- medal races
- worst race[s] exclusion
- non-integer scores
- series ties according to the `A8` Rule
## Installation
```
pip install -r requirements.txt
sudo apt-get install tesseract-ocr # apt-based Linux
brew install tesseract # macOS
```
You also need the `fonts-noto-cjk` font.
## Deployment
### Bare Metal
To run on bare metal, simply run:
```bash
python main.py
```
Ensure that Tesseract and required system dependencies are installed as per the [Installation](#installation) instructions.
### Docker
To run using Docker, use the provided `Dockerfile` and `docker-compose.yml`:
```bash
docker-compose up --build
```
This command builds the Docker image and starts the container.
## Support
Now you can buy me a coffee to encourage further development!
[](https://www.buymeacoffee.com/kirienko)