omniview 1.0.0

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

Omniview

Система для одновременного просмотра и обработки потоков с нескольких камер (USB/IP) с возможностью интеграции в компьютерное зрение.

🚀 Возможности

• Поддержка USB и IP-камер (через RTSP)
• Автоматическое переподключение при обрыве связи
• Настраиваемые параметры камер (разрешение, FPS)
• Многопоточная обработка кадров
• Гибкая система обратных вызовов для обработки видео
• Готовый GUI для просмотра потоков
• Конфигурирование через параметры конструктора

⚙️ Установка

1. Клонируйте репозиторий:

git clone https://github.com/DIMFLIX/OmniView.git
cd OmniView

2. Установите пакетный менеджер

3. Установите зависимости:

uv sync

4. Запустите базовый пример

python example.py

🛠️ Использование

Базовый пример для USB камер

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()

Базовый пример для IP камер

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

Основные методы:

• start() - запускает менеджер камер (блокирующий вызов)
• stop() - корректно останавливает все потоки
• process_frames() - возвращает словарь текущих кадров (ID: кадр)

Класс USBCameraManager

Параметры конструктора:

Параметр	Тип	По умолчанию	Описание
show_gui	bool	True	Показывать окна с видео
max_cameras	int	10	Макс. количество камер
frame_width	int	640	Ширина кадра
frame_height	int	480	Высота кадра
fps	int	30	Целевой FPS
min_uptime	float	5.0	Мин. время работы (сек)
frame_callback	function	None	Callback для обработки кадров
exit_keys	tuple	(ord('q'),27)	Клавиши для выхода

Класс IPCameraManager

Параметры конструктора (Все те-же самые что у USBCameraManager, но с добавлением):

Параметр	Тип	По умолчанию	Описание
rtsp_urls	list[str]	[]	Список RTSP URL

🤝 Развитие проекта

Приветствуются:

• Отчеты об ошибках
• Pull requests
• Идеи по улучшению
• Примеры использования

📄 Лицензия

Проект распространяется под лицензией GNU GPL v3. Подробности см. в файле LICENSE.