streamcap 1.0.0

Unified video capture for USB, RTSP, ESP32-CAM, HTTP MJPEG, and file sources with auto-reconnect.

📡 streamcap

Unified Video Capture — One API for Every Source

USB · RTSP · ESP32-CAM · HTTP MJPEG · Video Files

---

✨ Why streamcap?

Feature	streamcap	cv2.VideoCapture	imageio
Universal source detection	✅	❌	❌
ESP32-CAM auto-discovery	✅	❌	❌
Auto-reconnect on failure	✅	❌	❌
Frame metadata (FPS, ID)	✅	❌	✅
Iterator interface	✅	❌	✅
Zero config needed	✅	❌	❌

---

📦 Installation

pip install streamcap

---

🚀 Quick Start

import cv2
from streamcap import StreamCap

# USB Camera
cap = StreamCap(0)

# RTSP Stream
cap = StreamCap("rtsp://192.168.1.100:554/stream")

# ESP32-CAM (auto-find on network)
cap = StreamCap("esp32://auto")

# ESP32-CAM (specific IP)
cap = StreamCap("esp32://192.168.1.50")

# Video File
cap = StreamCap("drone_footage.mp4", resolution=(1280, 720))

# Iterate over frames
for frame, meta in cap:
    cv2.putText(frame, f"FPS: {meta['fps']:.1f} | Frame: {meta['frame_id']}",
                (10, 30), cv2.FONT_HERSHEY_SIMPLEX, 0.7, (0, 255, 0), 2)
    cv2.imshow("StreamCap", frame)
    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

cap.release()

---

🔧 API Reference

StreamCap(source, resolution=None, max_retries=5, retry_delay=2.0)

Source Format	Type	Example
int or "usb://N"	USB Camera	StreamCap(0)
"rtsp://..."	RTSP Stream	StreamCap("rtsp://ip/path")
"esp32://IP"	ESP32-CAM	StreamCap("esp32://192.168.1.50")
"esp32://auto"	ESP32 Auto	StreamCap("esp32://auto")
"http://..."	HTTP MJPEG	StreamCap("http://ip/stream")
"path/to/file"	Video File	StreamCap("video.mp4")

find_esp32(ip=None, subnets=None, timeout=0.3)

Auto-discover ESP32-CAM devices on the local network by scanning common subnets.

---

📜 License

MIT License — use it anywhere.

Built with ❤️ by ByIbos