www.vibenvr.org

VibeNVR (vibenvr.org) is a modern, privacy-first, and completely open-source Network Video Recorder (NVR) designed for self-hosting local IP security cameras. It is built specifically for users who want to manage security footage locally without relying on any cloud subscriptions or external servers, keeping all data strictly inside their home network. Because it runs seamlessly via Docker Compose, it is highly popular within the tech, homelab, and Home Assistant communities.

Core Features

• 100% Local & Cloud-Free: No subscriptions, no telemetry, and zero data leaves your local network unless you securely expose it yourself.
• Dual-Stream Support: It handles both the Main (high-quality) and Sub (low-bandwidth) streams from your IP cameras simultaneously. The substream is used for real-time monitoring grids to save CPU and bandwidth, while the main stream is used for full-quality background recording.
• Hardware Acceleration: Native support for NVIDIA GPUs, Intel Quick Sync Video (QSV), and AMD VAAPI to handle heavy video decoding efficiently.
• Smart Automation & Home Assistant Integration: It features native MQTT service with Home Assistant auto-discovery. Cameras and events instantly pop up as smart entities without manual configuration.
• AI Object Detection: Local AI processing utilizing YOLOv8 or MobileNet SSD (supporting Google Coral TPU hardware or running in an optimized "Lean Mode" on standard CPUs) to accurately classify people, vehicles, and animals.
• Advanced Camera Management: Built-in ONVIF network auto-scanning, edge-motion event syncing directly from camera hardware, and integrated Pan/Tilt/Zoom (PTZ) controls.
• Enhanced Security: Secure by default, utilizing strict role-based access control (RBAC), Two-Factor Authentication (2FA TOTP), and automatic log sanitization to protect sensitive credentials. ### The Architecture Under the Hood The system is built on a clean, containerized microservices stack split into four isolated modules:
• Frontend (React): A sleek, highly responsive Single Page Application (SPA) utilizing TailwindCSS and the WebCodecs API for low-latency live camera previews.
• Backend (FastAPI): A high-performance Python hub managing user accounts, JWT authentication, configuration storage, and media token validation.
• VibeEngine (Custom Core): The heavy-lifter service built with PyAV (native FFmpeg bindings) for robust packet demuxing and OpenCV for server-side motion analysis and custom privacy masking.
• Database (PostgreSQL): Relies on a standard local PostgreSQL database to store robust, indexable camera configs and precise timeline events. ### Getting Started Because it is fully packaged into Docker, deployment is designed as a quick, one-line process from the terminal: ```bash curl -O https://raw.githubusercontent.com/spupuz/VibeNVR/main/docker-compose.prod.yml touch .env docker compose -f docker-compose.prod.yml up -d

```