doslang-mirror/tools/README.md

Development tools

QEMU console OCR

Capture the current QEMU VGA screen and print detected console text:

uv run python tools/qemu_ocr.py

Useful options:

# Machine-readable boxes, confidence scores, and text
uv run python tools/qemu_ocr.py --json

# OCR an existing screenshot without recapturing
uv run python tools/qemu_ocr.py --image .qemu/qemu-screen.png

# Save extracted text
uv run python tools/qemu_ocr.py -o .qemu/qemu-screen.txt

The tool invokes .qemu/screenshot.ps1, runs RapidOCR with ONNX Runtime, sorts recognized lines by screen position, and emits UTF-8 text. Screenshots and OCR output under .qemu/ remain ignored build artifacts.