PanoOCR#

OCR for equirectangular panorama images. Handles perspective projection, coordinate conversion, and text deduplication.

Installation#

# Lightweight (bring your own engine)
pip install "panoocr @ git+https://github.com/yz3440/panoocr.git"

# With MacOCR (macOS only)
pip install "panoocr[macocr]"

# With EasyOCR (cross-platform)
pip install "panoocr[easyocr]"

# With all engines
pip install "panoocr[full] @ git+https://github.com/yz3440/panoocr.git"

Quick Start#

from panoocr import PanoOCR
from panoocr.engines.macocr import MacOCREngine

engine = MacOCREngine()
pano = PanoOCR(engine)
result = pano.recognize("panorama.jpg")
result.save_json("results.ocr.json")

Demo#

The preview tool visualizes OCR results on an interactive 3D sphere.

cd preview && python -m http.server

Open http://localhost:8000 and drag in the JSON result file and panorama image.

Next#