explaingit

648540858/wvp-gb28181-pro

6,925JavaAudience · ops devopsComplexity · 4/5LicenseSetup · hard

TLDR

wvp-GB28181-pro is a ready-to-deploy video surveillance server that connects IP cameras and recorders to a live-view and playback web interface using China's GB28181 national security-camera standard.

Mindmap

mindmap
  root((wvp-GB28181-pro))
    Standards
      GB28181 cameras
      RTSP and RTMP
      JT808 vehicle cams
    Features
      Live video view
      Recorded playback
      PTZ control
    Integrations
      Hikvision
      Dahua
      Regional platforms
    Tech
      Java backend
      ZLMediaKit
      Vue.js frontend
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Connect Hikvision, Dahua, or Uniview cameras to a central web dashboard for live viewing and recorded footage playback.

USE CASE 2

Ingest RTSP and RTMP camera streams that don't support GB28181 and expose them through a compliant surveillance platform.

USE CASE 3

Manage vehicle dashcam and fleet camera feeds using JT808 and JT1078 transport standards alongside fixed IP cameras.

USE CASE 4

Link a local camera network upward to a city or regional GB28181 aggregation platform.

Tech stack

JavaVue.jsZLMediaKitMySQLPostgreSQL

Getting it running

Difficulty · hard Time to first run · 1day+

Requires deploying the Java backend, ZLMediaKit media server, and a database, all three must be running before cameras can register.

MIT license, use, copy, modify, and distribute for any purpose including commercial, with attribution.

In plain English

wvp-GB28181-pro is a ready-to-deploy video surveillance management platform built around Chinese national standards for networked security cameras. GB28181 is a Chinese government specification that defines how IP cameras, recorders, and surveillance platforms communicate with each other over a network. This project provides the server software and web interface that lets security cameras register, stream live video, and be controlled remotely, all according to that standard. The platform connects to cameras and network video recorders from major brands including Hikvision, Dahua, and Uniview. It also accepts RTSP and RTMP streams from cameras that do not natively support the national standard, converting them so they can appear on platforms that require GB28181 compliance. For vehicle-mounted cameras, it supports the JT808 and JT1078 transport standards commonly used in Chinese fleet tracking and dashcam systems. From the built-in web interface, operators can watch live feeds, play back recorded footage stored on the camera or recorder, control pan-tilt-zoom on supported cameras, set recording schedules, and view device locations on a map. The platform can also connect upward to higher-level national-standard aggregation platforms, which is how city or regional surveillance networks link many local systems together. Alert events from cameras, such as motion detection or perimeter crossing, are received, displayed, and can trigger automatic snapshots or recording playback. The project uses a Java backend alongside the ZLMediaKit open-source media server for stream handling, and a Vue.js frontend for the web interface. It supports MySQL and PostgreSQL databases, can be deployed with the frontend and backend on separate servers, and scales to tens of thousands of simultaneous device connections according to the project's own load tests. The open-source core is MIT licensed. Commercial add-ons covering ONVIF support, Hikvision private protocol integration, and additional management features are available separately.

Copy-paste prompts

Prompt 1
Help me deploy wvp-GB28181-pro with MySQL on a Linux server and connect a Hikvision camera using its GB28181 settings.
Prompt 2
My cameras use RTSP but not GB28181. How do I add RTSP streams to wvp-GB28181-pro so they appear alongside GB28181 devices?
Prompt 3
I want wvp-GB28181-pro to send motion-detection alerts from cameras and automatically take a snapshot when triggered. How do I configure that?
Prompt 4
Walk me through connecting wvp-GB28181-pro to a higher-level national surveillance aggregation platform as a lower-level node.
Open on GitHub → Explain another repo

← 648540858 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.