Since the new updates arrived, you guys don’t really need this anymore.

UmatoMusume

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).

Sections

• 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

Disclaimer

• 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.

How does it works ?

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.

Features

| Feature | Description | |-----------------------|-----------------------------------------------------------------------------| | Options suggestion | Show recommended choices and their effects when an event appears. | | Real-time OCR | Capture game screen text automatically and detect events instantly. | | String similarity | Handle OCR mistakes by fuzzy matching against event database. |

How to use this application ?

Installation

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

Set captures area for OCR

• 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.

NEW Game8 Scraping Method

• This setting is available in Config menu called "Use Game8 Scraping Method".
• Using Game8 Scraping method will automatically scrap Game8 website and match the event name.
• Choosing Uma name is optional but it will give you more accurate result.
• Scrap Data will be cache automatically for faster latency and will be renew every 7 days.

Download/Crawl new data

• 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.

| Button | Description | |----------------------------|-----------------------------------------------------------------------------| | Download/Crawl uma data | Get umas events and objectives | | Download/Crawl support | Get support cards events | | Download/Crawl career | Get careers events | | Download/Crawl races | Get races infos with date/time |

Choose OCR engine from config

• 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.

Build

• 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]

Dependencies

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

License

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

Acknowledgments

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