Skip to main content

📝 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
  • Hardware-accelerated decoding (D3D11 on Windows, VAAPI on Linux) with automatic software fallback
  • 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,
        show_camera_id=True,
        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",
        ],
        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 False 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
hw_acceleration bool True Use GPU video decoding when available (D3D11/VAAPI); falls back to software
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

🎨 Built With

Developed on

Meowrch Linux

Meowrch — A Linux distribution built for creators and developers

🤝 Contributing

Contributions are welcome! Here's how you can help:

  • 🐛 Report bugs and request features via Issues
  • 🔧 Submit pull requests with improvements
  • 📖 Improve documentation

®️ Legal status

This project is protected by patent. All rights reserved. Use, copying, and distribution are permitted only with the written permission of the copyright holder.

Page 1 Page 2

📝 License

This project is licensed under the GPL-3.0 License - see the LICENSE file for details.

Metadata

Release files for omniview 1.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for omniview 1.3.0
File Size Uploaded Provenance Actions
omniview-1.3.0.tar.gz 52.4 kB Without provenance Details for omniview-1.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for omniview 1.3.0
File Interpreter ABI Platform Actions
omniview-1.3.0-py3-none-any.whl Python 3 none any Details for omniview-1.3.0-py3-none-any.whl

Total release size: 96.3 kB

Release files / omniview-1.3.0.tar.gz

Download URL omniview-1.3.0.tar.gz
Size 52.4 kB
Tags Source
SHA-256 checksum
How to use checksums
8986405573985d08d7bc2ba202172e5f8af3d7097e7bc17884fe53ee455916a1
BLAKE2b-256 checksum
How to use checksums
2935dbe51b5854698ff8d4c4b51703d1ec85b8dfec56a89f76a79c4742aacd9b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Release files / omniview-1.3.0-py3-none-any.whl

Download URL omniview-1.3.0-py3-none-any.whl
Size 43.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
77df54051d9018cc72b90a69870e04e7f2615a2d7fb4c92342d4800eb592e5ec
BLAKE2b-256 checksum
How to use checksums
e69ba0c97220c5377ab89447291b530049032111d75d2220f6ebf5d67d5cadd1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Security for omniview 1.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page