📝 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
🤝 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.