A Windows desktop application that assists players of Umamusume Pretty Derby by providing a real-time event tracker and choice assistant using OCR (Optical Character Recognition).

• UmatoMusume
• Sections
• Disclaimer
• How does it works ?
• Features
• How to use this application ?
  • Installation
  • Set captures area for OCR
  • Download/Crawl new data
• Build
• Dependencies
• License
• Acknowledgments

• I can't guarantee you that using this tool will not get your account banned.
• This application interacts with the game through screen capture and OCR, which may violate Cygames' Terms of Service.
• Use it at your own risk.

The application uses OCR (Optical Character Recognition) to capture text directly from the game screen. Once the text is recognized, it compares the result with its built-in event database.

• When an event appears in the game, the app scans it in real-time.
• The recognized text is then matched against known events using string similarity (to handle OCR mistakes).
• After matching, the app displays the corresponding choices and their effects so players can make the best decision immediately.

• Download the latest release.
• Extract the zip file to a folder of your choice.
• Run UmatoMusume.exe.

• At the main menu, there are two capture buttons, [Capture event] & [Capture date/time].
• How to capture:
  • Simply click the [Capture event]/[Capture date/time] button.
  • Hold & drag the area that contains events/datetime.
  • Enjoy !
• Set area for events: Watch the video
• Set area for date/time: Watch the video
• The event box only display choices after you choose an uma from combobox.

• This feature helps you to get the latest data from gametora. Basically, it just a web crawler.
• At the main menu, when click the [Download data], a dialog will appear:

• Download button: Fetches JSON files directly from GitHub, which is faster than crawling.
• Crawl button: Use this when the repo hasn’t been updated recently. It allows you to fetch the data yourself.

• I gave you two options for OCR engine: PaddleOCR & RapidOCR.
  • PaddleOCR: More accurate than RapidOCR but uses more RAM (=< 600mb). (Default)
  • RapidOCR: Less accurate but uses less RAM (=< 300mb).
• Choose one that fits your PC.
• You should be fine with PaddleOCR if you have 8GB+ RAM.

• This project uses .NET 9.0 and can be built using Visual Studio or the .NET CLI.

git clone https://github.com/akarindt/UmatoMusume.git
cd UmatoMusume
./build.bat [target]

• Selenium
• Tesseract OCR (Old versions)
• RapidOCR (Newest versions)
• PaddleOCR (Newest versions)
• FuzzySharp
• StringSimilarity.NET

• This project is licensed under the MIT License. See the LICENSE file for details.

• Game data sourced from GameTora
• Special thanks to the Umamusume community