omniview 1.1.0

Receiving video stream from multiple cameras (usb/ip) for further processing

---

📝 About the project

A system for simultaneous viewing and processing of streams from multiple cameras (USB/IP) with the ability to integrate into computer vision.

🚀 Features

• Support for USB and IP cameras (via RTSP)
• Automatic reconnection in case of connection failure
• Customizable camera parameters (resolution, FPS)
• Multithreaded frame processing
• Flexible callback system for video processing
• Ready-to-use GUI for viewing streams
• Configuration via constructor parameters

⚙️ Installation

pip install omniview

🛠️ Usage

🔌 Basic example for USB cameras

from omniview.managers import USBCameraManager


def frame_callback(camera_id, frame):
    # Your framing
    pass


if __name__ == "__main__":
    manager = USBCameraManager(
        show_gui=True,
        max_cameras=4,
        frame_callback=frame_callback
    )
    try:
        manager.start()
    except KeyboardInterrupt:
        manager.stop()

🌐 Basic example for IP cameras

from omniview.managers import IPCameraManager


def frame_callback(camera_id, frame):
    # Your framing
    pass


if __name__ == "__main__":
    manager = IPCameraManager(
        show_gui=True,
        rtsp_urls=[
            "rtsp://admin:12345@192.168.0.1:9090",
        ],
        max_cameras=4,
        frame_callback=frame_callback
    )
    try:
        manager.start()
    except KeyboardInterrupt:
        manager.stop()

📚 API

Main methods:

• start() - starts the camera manager (blocking call)
• stop() - stops all threads correctly

Class USBCameraManager

Designer Parameters:

Parameter	Type	Default	Description
show_gui	bool	True	Show video windows
show_camera_id	bool	False	Adds a caption with the camera ID to the frame
max_cameras	int	10	Max. number of cameras
frame_width	int	640	frame width
frame_height	int	480	frame height
fps	int	30	target FPS
min_uptime	float	5.0	Min. uptime (sec)
frame_callback	function	None	Callback for frame processing
exit_keys	tuple	(ord('q'),27)	exit keys
sequential_mode	bool	False	Method to show the cameras one by one
switch_interval	float	5.0	The time after which the cameras will change. Only works if sequential_mode is selected

Class IPCameraManager

Builder parameters (Same as USBCameraManager, but with an addition):

Parameter	Type	Default	Description
rtsp_urls	list[str]	[]	List of RTSP URLs

🤝 Project Development

Welcome:

• Bug reports
• Pull requests
• Ideas for improvement
• Usage examples

📄 License

The project is distributed under the GNU GPL v3 license. See the LICENSE file for details.