VibeNVR is a modern, flexible, and containerized video surveillance system tailored for managing IP cameras, recordings, motion detection, and a unified event timeline. The project utilizes a custom high-performance video engine, known as VibeEngine, which is designed for efficiency and reliability, all presented through a premium React-based user interface.

Key Features

• Modern Web Interface: An ultra-premium UI built using React, Vite, and Lucide icons ensures a sleek user experience.
• Customizable Dashboard: Adapt widgets and graphs to meet specific monitoring needs.
• Secure by Design: Comprehensive security with full JWT authentication for APIs, streams, and static media, preventing unauthorized access.
• Advanced Video Engine: Leverages a custom Python engine with OpenCV and FFmpeg for efficient RTSP streaming and processing.
• Passthrough Recording: Offers direct stream copy support for near-zero CPU usage during recording with experimental features and auto fallback.
• Smart Motion Detection: Native motion detection with adjustable sensitivity and pre/post-capture buffers enhances security monitoring.
• Event Timeline: A unified browser for recordings and high-resolution snapshots with instant filtering capabilities.
• Storage Management: Automated background cleanup and bulk deletion tools help manage storage efficiently.
• Camera Groups: Organize cameras into custom groups for streamlined monitoring.
• Timezone Synchronization: Full ISO 8601 support for accurate timing across the system components.
• Real-time Monitoring: Dynamic MJPEG stream proxying for live views with adaptive frame polling.
• Dockerized: Deployment is hassle-free with zero dependencies supported by Docker Compose.

Security & Architecture

VibeNVR prioritizes security with a robust architecture that includes:

• Authenticated Media: Static media files require a valid JWT token for access.
• Protected Internal Ports: Backend and engine are not accessible from outside the local host, preventing exposure to direct attacks.
• Reverse Proxy Compatibility: The system is designed to work securely behind a reverse proxy such as Nginx Proxy Manager, enhancing security through controlled access.

Architecture Overview

The system consists of four main microservices:

• Frontend: A React-based single-page application (SPA).
• Backend: FastAPI server for logic handling and secure database access.
• VibeEngine: Custom processing engine for motion detection and recording.
• Database: PostgreSQL for persistent storage of camera configurations and events.

VibeNVR is currently in beta development, meaning continual updates and adjustments are expected as the database schema evolves. While every effort is made toward backward compatibility, manual migration steps may be necessary for new version updates.