umeko-py-thermal

English | 中文

Python SDK for Umeko ESP32-based thermal imaging cameras.
Read temperature matrices in real-time over serial port — no GUI boilerplate required.

Supported sensors (auto-detected):

Install

pip install umeko-py-thermal

Requires Python ≥ 3.8, pyserial, numpy, and Pillow.

Quick start

from umeko_thermal import ThermalCamera

# Auto-detect serial port
cam = ThermalCamera(auto_detect=True)
cam.connect()

# Stream 100 frames
for frame in cam.stream(max_frames=100):
    print(f"max={frame.max():.1f}°C  min={frame.min():.1f}°C")

cam.disconnect()

Or use the context manager:

from umeko_thermal import ThermalCamera

with ThermalCamera(port="COM3") as cam:
    for frame in cam.stream(max_frames=200):
        mat = frame.to_numpy()   # shape: (height, width)
        img = frame.to_image(scale=10, colormap="stream")
        img.save("thermal.png")

Live preview window

with ThermalCamera(port="COM3") as cam:
    cam.show(scale=15, colormap="inferno")

Opens a small blocking window that renders the live stream.
Everything runs on the main thread — no background workers. Closing the window stops the stream, drains the serial buffer, and returns control to your script.

Device filesystem

The camera can store .bin snapshots on its internal flash:

files = cam.list_files()          # [FileInfo(name="IMG_001.bin", size=2048, type="32x32")]
frame = cam.read_file("IMG_001.bin")
frame.to_image().save("snapshot.png")

cam.delete_file("IMG_001.bin")
cam.clear_all_files()

API at a glance

ThermalFrame

Documentation

See docs/SDK.md for the full design spec and protocol details.

License

MIT