haythemusv 0.1.0

Ultra low-latency RTSP stream interception library for USV robotics

haythemusv

An ultra low-latency RTSP video stream library designed for Unmanned Surface Vehicles (USV) and robotics.

This library bypasses standard OpenCV/FFmpeg buffering to provide near-instant real-time video feeds by aggressively dropping stale frames and using hardware-accelerated decoding.

Installation

pip install haythemusv

Note: Requires ffmpeg to be installed and available in your system PATH.

Usage

from haythemusv import USVStream
import cv2

# Initialize the stream (optimized for Dahua/Amcrest sub-streams)
url = "rtsp://admin:password@192.168.1.161:554/cam/realmonitor?channel=1&subtype=1"
cam = USVStream(url, width=640, height=352)

try:
    while cam.is_alive():
        frame = cam.get_frame()
        if frame is not None:
            cv2.imshow("USV Real-Time Feed", frame)
        
        if cv2.waitKey(1) & 0xFF == 27:
            break
finally:
    cam.stop()
    cv2.destroyAllWindows()

Features

• Zero Latency: Aggressive frame-drop strategy ensures you always see the latest microsecond.
• Hardware Accelerated: Automatically uses NVIDIA NVDEC (h264_cuvid) if available.
• Threaded Pipeline: Background FFmpeg pipe maintains steady flow without blocking your main AI/Control loop.
• Lightweight: Minimal dependencies (numpy, opencv-python).

License

MIT