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.