RoK Monster OCR

Leadership Change

🌞 It brings me great pleasure to announce the golang fork by xor22h will be the official supported OCR client of the RoK Monster community.

Kingdom Statistics

Command line tools to help collect player statistics from Rise of Kingdoms. By analyzing screenshots we can extract various data points such as governor power, deaths, kills and more. This can help with various kingdom statistics or fairly distributing KvK rewards.



  • Character recognition by Tesseract
  • Fast hash based image comparison
  • Live results with adb


  • Best results with a 16:9 image at 1920*1080.
  • English language is preferred, as coordinate information lines up most accurately with English.


Below is a quick overview of the actions performed while executing the job governor-more-info-kills.

  1. rok-monster-ocr will iterate through each screenshot and compare the input image to a known fingerprint of the image containing data to capture.
  2. If a match is made the image is prepared per the instructions declared in the OCR profile. Each cropped segment represents a single data point.
    • This process is repeated for each image in the input_path.
  3. By default on completion a table is printed via CLI and a CSV file is saved in the current working directory.

📌 Input path can be defined in .env file or via CLI argument --input_path.


Official Support

  • Ubuntu 20.04.2


One line install.

curl -sSL | bash -s y

This will install all necessary dependencies and start a small demo project.