An OCR Tool using Windows.Media.Ocr.OcrEngine API

An OCR Tool using Windows.Media.Ocr.OcrEngine API.

Usage: winocr.exe [OPTIONS] [FILES]...

Arguments:
  [FILES]...  Input files

Options:
  -o, --ocr          OCR and export text files
  -s, --server       Run HTTP Server
  -a, --auth <AUTH>  HTTP Basic Auth (username:password) [default: ]
  -p, --port <PORT>  HTTP port number [default: 8000]
  -h, --help         Print help
  -V, --version      Print version

winocr *.png

winocr -o *.png

winocr -s -p 8080

winocr -s -a admin:password123 -p 8080

After starting the HTTP server, you can upload an image from the homepage HTML or use curl to send an image via the upload API:

curl -u admin:password123 -H "Accept: application/json" -X POST http://localhost:8080/upload -F "file=@01.png"

The JSON response looks like this:

{
    "success": true,
    "message": "File uploaded successfully",
    "ocr_result": "Hello\nworld\n",
    "image_width": 1679,
    "image_height": 1081,
    "ocr_boxes": [
        {
            "text": "Hello",
            "x": 268.0,
            "y": 218.0,
            "w": 353.0,
            "h": 153.0
        },
        {
            "text": "world",
            "x": 506.0,
            "y": 670.0,
            "w": 433.0,
            "h": 168.0
        }
    ]
}

image_width and image_height represent the width and height of the image (in px), x and y represent the top-left origin of the text bounding box (in px), w and h represent the width and height of the text bounding box (in px).

cargo install winocr
winocr -h

• Directly call the Windows.Media.Ocr.OcrEngine API for OCR
• Command-line mode: allows batch processing of image files and exports OCR results as TXT files
• HTTP server mode: provides a web interface to upload images and return OCR results
• Supports both HTML form upload and API interfaces
• Configurable HTTP Basic Auth authentication
• The maximum upload image size is 100 MB

• Windows users need to perform batch OCR processing
• Applications that need to integrate OCR functionality via API

MIT License