bkbillybk/hikvision-hub repository overview

⁠Hikvision Hub

A modern, high-performance, mobile-first surveillance hub and NVR web interface for Hikvision IP cameras, NAS storage, and SD card recordings.

⁠✨ Features

• 🚀 Ultra-Lightweight & Fast: Written in Go with minimal resource footprint (<25MB RAM idle).
• 🎬 On-The-Fly Video Extraction & Remuxing: Direct byte-range seeking from Hikvision hiv*.mp4 recording chunks with native HTML5 HTTP Range video streaming.
• ⏱️ Interactive Touch Timeline: Smooth pinch-to-zoom (days to minutes), color-coded motion events, and fast seeking.
• 🔎 Multi-Format Storage Indexer: Automatically parses and indexes both legacy binary structures (info.bin, index00.bin) and modern SQLite indices (record_db_index00).
• 📡 Multi-Camera Live View: Auto-refreshing live snapshot grid with single-tap focus and ISAPI digest auth.
• 🏠 Home Assistant Integration: Companion custom integration (hikvision-hub-ha⁠) for Home Assistant Media Browser with live thumbnail previews.

⁠🚀 Quick Start

version: '3'
services:
  hikvision_hub:
    image: bkbillybk/hikvision-hub:latest
    container_name: hikvision-hub
    restart: unless-stopped
    volumes:
      - .hikvision-hub:/app/data
      - /mnt/hikvision:/mnt
    ports:
      - 85:8080
    environment:
      - PORT=8080
      - DATA_DIR=/app/data
      - INITIAL_USER=admin
      - INITIAL_PASS=admin
      - TZ=UTC