Viewtron Python SDK

Python SDK for Viewtron IP camera API. Parse inbound alarm events and control cameras programmatically.

Viewtron IP cameras run AI detection on-camera (license plate recognition, face detection, human/vehicle detection) and send HTTP POST events to your server. This SDK parses those events and provides an API client for camera control.

Install

pip install viewtron

Inbound Events — Parse Camera Alarm Data

Viewtron cameras and NVRs send XML alarm events via HTTP POST. This SDK parses them into Python objects.

from viewtron import ViewtronServer

def on_event(event, client_ip):
    if event.category == "lpr":
        print(event.get_plate_number())       # "ABC1234"
        print(event.get_plate_group())        # "whiteList" or NVR group name

        # Images as decoded JPEG bytes — ready for saving, MQTT, notifications
        overview = event.get_source_image_bytes()   # full scene
        plate_crop = event.get_target_image_bytes() # plate closeup

server = ViewtronServer(port=5050, on_event=on_event)
server.serve_forever()

Supported Event Types

Version detection is automatic — IPC v1.x and NVR v2.0 use different XML structures but the SDK handles both.

Outbound API — Control the Camera

from viewtron import ViewtronCamera

camera = ViewtronCamera("192.168.0.20", "admin", "password")

# Device info
info = camera.get_device_info()
print(info["model"])  # "LPR-IP4"

# Manage the license plate database
plates = camera.get_plates()
camera.add_plate("ABC1234")
camera.modify_plate("ABC1234", owner="Mike", telephone="555-1234")
camera.delete_plate("ABC1234")

# Or use as context manager
with ViewtronCamera("192.168.0.20", "admin", "password") as cam:
    plates = cam.get_plates()

Projects Using This SDK

• Viewtron Home Assistant Integration — Camera events as HA sensors via MQTT auto-discovery
• IP Camera API Server — Alarm server with CSV logging and image saving

Documentation

• API Developer Docs — Full Viewtron API documentation portal
• Python SDK Reference — Event classes, camera client, version routing
• Home Assistant Integration — Connect cameras to HA via MQTT
• XML Event Examples
• IP Camera Setup Guide
• NVR Setup Guide

Products

• All Viewtron Products
• AI Security Cameras
• LPR Cameras
• Face Recognition Cameras

Author

Mike Haldas — CCTV Camera Pros mike@cctvcamerapros.net