Merge pull request #310 from ch-bas/release/2.1.0

Release 2.1.0 — community_notes + sensor_size_inch + AD410 NVR fix

Author: ch-bas

.github/ISSUE_TEMPLATE/camera-quirk.yml

@@ -0,0 +1,47 @@
+name: "🔧 Report a quirk / behavior"
+description: "Something this camera does that isn't in the datasheet — RTSP oddities, ONVIF bugs, firmware regressions, etc."
+title: "Quirk: [Brand] [Model] — [short description]"
+labels: ["community-note"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        This is for **observed behavior**, not spec corrections. If a spec value in the database is wrong, use the "Correct an existing entry" template instead.
+
+  - type: input
+    id: camera
+    attributes:
+      label: "Which camera?"
+      placeholder: "e.g. Hikvision DS-2CD2387G2-LU"
+    validations:
+      required: true
+
+  - type: textarea
+    id: note
+    attributes:
+      label: "What does it do?"
+      description: "One behavior per issue. What happens, under what condition."
+      placeholder: "e.g. Substream drops to 5fps when WDR is enabled, regardless of the fps set in the UI."
+    validations:
+      required: true
+
+  - type: dropdown
+    id: category
+    attributes:
+      label: "Category"
+      options: ["rtsp", "onvif", "firmware", "audio", "ptz", "power", "network", "frigate", "home_assistant", "blue_iris", "other"]
+
+  - type: input
+    id: firmware
+    attributes:
+      label: "Firmware version (if known)"
+      placeholder: "e.g. V5.7.3 build 230801"
+
+  - type: input
+    id: source
+    attributes:
+      label: "Source"
+      description: "Link to the thread / issue / video where this is discussed. If you found it yourself on your own device, write: empirical"
+      placeholder: "https://… or empirical"
+    validations:
+      required: true

CHANGELOG.md

@@ -6,6 +6,20 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 
 ---
 
+## [2.1.0] — 2026-08-22
+
+Adds the **`community_notes`** layer — per-camera observed behaviors/quirks that aren't in the datasheet — plus a build-time `sensor_size_inch` field for the site's sort-by-sensor, and a community data fix.
+
+### Added
+- **`community_notes` schema block** — an optional array of user-reported behaviors/quirks (RTSP/ONVIF oddities, firmware regressions, integration gotchas). Explicitly **not specs** and **not project-verified**: each note carries a `source` (URL or the literal `empirical`) + `reported_by` + `date`, rendered under an "unverified" heading. The datasheet-only rule for specs is unchanged.
+  - Tooling: `npm run add-note` CLI (revalidates before writing), a `camera-quirk.yml` issue template (label `community-note`), lint checks (reject empty arrays / datasheet-domain sources; warn on spec-correction-looking text and implausible dates), a `community_notes_count` CSV column, per-camera docs section, and a coverage summary line. Seeded with 4 sourced notes.
+- **`sensor_size_inch`** — a numeric sensor size derived at build time from the `sensor` string (`1/2.8"` → 0.3571), injected into `data/cameras.json` so the site can sort by sensor size without runtime parsing. ~2,776 cameras get it.
+
+### Fixed
+- **Amcrest AD410 doorbell is NVR-compatible (#307):** `storage.nvr_compatible` corrected false → true (Dahua-protocol doorbell; owner-confirmed on an Amcrest NVR).
+
+---
+
 ## [2.0.1] — 2026-08-22
 
 Adds a `network.ethernet_speed_mbps` schema field and backfills it for 280 PoE cameras across five brands (with a companion NetBox devicetype-library export), plus a batch of community-reported camera/config fixes and deeper Frigate/go2rtc integration notes.

CONTRIBUTING.md

@@ -225,6 +225,47 @@ See [`configs/README.md`](configs/README.md) for templates and full details.
 
 ---
 
+## Community notes (quirks and behaviors)
+
+Datasheets tell you what a camera claims to do. They don't tell you that the substream drops to 5fps when WDR is on, or that ONVIF events stop working after a specific firmware. That knowledge is spread across forum threads and gets lost.
+
+Each camera can carry a `community_notes` array for exactly this. These are **observed behaviors, not specs**, and they are **not verified by the project** — the source link and reporter name carry the accountability.
+
+### What belongs here
+- RTSP/ONVIF oddities (wrong default path, substream limits, auth quirks)
+- Firmware-specific regressions or fixes
+- Integration gotchas for Frigate / Home Assistant / Blue Iris
+- Power/PoE behavior under load, hardware revisions with different behavior
+
+### What does NOT belong here
+- Spec corrections. If the database says 20m IR and the datasheet says 30m, that's a correction — use the spec fields and link the datasheet.
+- Opinions ("image quality is bad"), purchasing advice, or comparisons.
+- Anything without a source.
+
+### How to add one
+**Easiest:** open a [quirk report issue](https://github.com/ch-bas/cctv-camera-database/issues/new?template=camera-quirk.yml) and we'll file it.
+
+**PR:** add to the camera's JSON:
+
+```json
+"community_notes": [
+  {
+    "note": "Substream drops to 5fps when WDR is enabled, regardless of the fps set in the UI.",
+    "category": "rtsp",
+    "firmware": "V5.7.3 build 230801",
+    "source": "https://github.com/blakeblackshear/frigate/discussions/12345",
+    "reported_by": "yourhandle",
+    "date": "2026-08-22"
+  }
+]
+```
+
+Or run `npm run add-note -- --id hikvision-ds-2cd2387g2-lu`.
+
+`source` is a URL, or the literal word `empirical` if you observed it on your own device. Contradicting notes are fine — different firmware, different behavior. We don't delete old notes; `firmware` and `date` let readers judge.
+
+---
+
 ## Corrections
 
 Found a mistake? [Open a correction issue](../../issues/new?template=correction.yml) — no need to fork anything.

COVERAGE.md

@@ -1,25 +1,27 @@
 # 📊 Field coverage
 
-> Auto-generated by `scripts/coverage-report.js` (do not edit by hand). Last updated: 2026-08-13.
+> Auto-generated by `scripts/coverage-report.js` (do not edit by hand). Last updated: 2026-08-22.
 
-![environment 100%](https://img.shields.io/badge/environment-100%25-brightgreen) ![FOV 89%](https://img.shields.io/badge/FOV-89%25-brightgreen) ![streams 61%](https://img.shields.io/badge/streams-61%25-green) ![dimensions 54%](https://img.shields.io/badge/dimensions-54%25-yellow) ![IK rating 36%](https://img.shields.io/badge/IK%20rating-36%25-orange) ![color min-lux 59%](https://img.shields.io/badge/color%20min--lux-59%25-yellow) ![Frigate 82%](https://img.shields.io/badge/Frigate-82%25-brightgreen)
+![environment 100%](https://img.shields.io/badge/environment-100%25-brightgreen) ![FOV 92%](https://img.shields.io/badge/FOV-92%25-brightgreen) ![streams 53%](https://img.shields.io/badge/streams-53%25-yellow) ![dimensions 50%](https://img.shields.io/badge/dimensions-50%25-yellow) ![IK rating 43%](https://img.shields.io/badge/IK%20rating-43%25-yellow) ![color min-lux 64%](https://img.shields.io/badge/color%20min--lux-64%25-green) ![Frigate 82%](https://img.shields.io/badge/Frigate-82%25-brightgreen)
 
-**2,904 cameras** across **74 brands**.
+**3,433 cameras** across **77 brands**.
 
 | Field | Coverage | Filled | Lane |
 |---|---|---:|:---:|
-| 🌍 Environment (in/outdoor) | `██████████` 100% | 2,904 | [#123](https://github.com/ch-bas/cctv-camera-database/issues/123) |
-| 🔎 Lens | `█████████░` 94% | 2,719 |  |
-| 📡 Field of view | `█████████░` 89% | 2,572 | [#179](https://github.com/ch-bas/cctv-camera-database/issues/179) |
-| 💧 IP rating | `█████████░` 89% | 2,580 |  |
-| 🔬 Sensor | `█████████░` 87% | 2,519 |  |
-| 🔧 Frigate config | `████████░░` 82% | 2,395 | [#170](https://github.com/ch-bas/cctv-camera-database/issues/170) |
-| 🎞️ Video streams | `██████░░░░` 61% | 1,759 | [#177](https://github.com/ch-bas/cctv-camera-database/issues/177) |
-| 🌙 Min-lux (color) | `██████░░░░` 59% | 1,725 | [#161](https://github.com/ch-bas/cctv-camera-database/issues/161) |
-| 📐 Dimensions | `█████░░░░░` 54% | 1,567 | [#178](https://github.com/ch-bas/cctv-camera-database/issues/178) |
-| 🗺️ Markets | `█████░░░░░` 52% | 1,509 | [#166](https://github.com/ch-bas/cctv-camera-database/issues/166) |
-| ⚖️ Weight | `█████░░░░░` 47% | 1,368 | [#178](https://github.com/ch-bas/cctv-camera-database/issues/178) |
-| 📅 Release year | `████░░░░░░` 38% | 1,104 | [#166](https://github.com/ch-bas/cctv-camera-database/issues/166) |
-| 🛡️ IK / impact rating | `████░░░░░░` 36% | 1,042 | [#162](https://github.com/ch-bas/cctv-camera-database/issues/162) |
+| 🌍 Environment (in/outdoor) | `██████████` 100% | 3,428 | [#123](https://github.com/ch-bas/cctv-camera-database/issues/123) |
+| 🔎 Lens | `█████████░` 94% | 3,220 |  |
+| 📡 Field of view | `█████████░` 92% | 3,155 | [#179](https://github.com/ch-bas/cctv-camera-database/issues/179) |
+| 💧 IP rating | `█████████░` 88% | 3,035 |  |
+| 🔬 Sensor | `█████████░` 87% | 2,996 |  |
+| 🔧 Frigate config | `████████░░` 82% | 2,831 | [#170](https://github.com/ch-bas/cctv-camera-database/issues/170) |
+| 🌙 Min-lux (color) | `██████░░░░` 64% | 2,189 | [#161](https://github.com/ch-bas/cctv-camera-database/issues/161) |
+| 🎞️ Video streams | `█████░░░░░` 53% | 1,827 | [#177](https://github.com/ch-bas/cctv-camera-database/issues/177) |
+| 📐 Dimensions | `█████░░░░░` 50% | 1,708 | [#178](https://github.com/ch-bas/cctv-camera-database/issues/178) |
+| 🗺️ Markets | `█████░░░░░` 49% | 1,673 | [#166](https://github.com/ch-bas/cctv-camera-database/issues/166) |
+| ⚖️ Weight | `████░░░░░░` 44% | 1,505 | [#178](https://github.com/ch-bas/cctv-camera-database/issues/178) |
+| 🛡️ IK / impact rating | `████░░░░░░` 43% | 1,463 | [#162](https://github.com/ch-bas/cctv-camera-database/issues/162) |
+| 📅 Release year | `████░░░░░░` 35% | 1,196 | [#166](https://github.com/ch-bas/cctv-camera-database/issues/166) |
+
+Cameras with community notes: 4 (4 notes total).
 
 Help raise a lane — see [open data-collection issues](https://github.com/ch-bas/cctv-camera-database/issues) (index: #163).

README.md

@@ -9,7 +9,7 @@ An open, structured database of 3,433 CCTV / IP camera models and their technica
 ### Field coverage
 
 <!-- coverage:start (auto-generated by scripts/coverage-report.js — do not edit by hand) -->
-![environment 100%](https://img.shields.io/badge/environment-100%25-brightgreen) ![FOV 89%](https://img.shields.io/badge/FOV-89%25-brightgreen) ![streams 61%](https://img.shields.io/badge/streams-61%25-green) ![dimensions 54%](https://img.shields.io/badge/dimensions-54%25-yellow) ![IK rating 36%](https://img.shields.io/badge/IK%20rating-36%25-orange) ![color min-lux 59%](https://img.shields.io/badge/color%20min--lux-59%25-yellow) ![Frigate 82%](https://img.shields.io/badge/Frigate-82%25-brightgreen)
+![environment 100%](https://img.shields.io/badge/environment-100%25-brightgreen) ![FOV 92%](https://img.shields.io/badge/FOV-92%25-brightgreen) ![streams 53%](https://img.shields.io/badge/streams-53%25-yellow) ![dimensions 50%](https://img.shields.io/badge/dimensions-50%25-yellow) ![IK rating 43%](https://img.shields.io/badge/IK%20rating-43%25-yellow) ![color min-lux 64%](https://img.shields.io/badge/color%20min--lux-64%25-green) ![Frigate 82%](https://img.shields.io/badge/Frigate-82%25-brightgreen)
 
 📊 **[Full field-coverage report → COVERAGE.md](COVERAGE.md)**
 <!-- coverage:end -->
@@ -47,6 +47,7 @@ Prefer to self-host or browse offline? A [standalone demo](docs/demo.html) (just
 - **Filter** — narrow by brand, camera type, night vision, resolution, or market
 - **Sort** — click any column header to sort ascending/descending
 - **Detail drawer** — click a row to slide open the full spec sheet (resolution, connectivity, protocols, storage, audio, pricing, source links)
+- **Community notes** — user-reported quirks and behaviors per camera, sourced and attributed, kept separate from datasheet specs
 - **Pagination** — page through all 3,433 cameras, 25 per page
 - **Stats bar** — live counts for total cameras, brands, 4K+, WiFi, and no-subscription models
 

cameras/amcrest/ad410-doorbell.json

@@ -33,7 +33,7 @@
   "storage": {
     "onboard": false,
     "max_microsd_gb": 128,
-    "nvr_compatible": false,
+    "nvr_compatible": true,
     "cloud": true
   },
   "protocols": [
@@ -64,7 +64,7 @@
   "markets": [
     "global"
   ],
-  "last_verified": "2026-08-21",
+  "last_verified": "2026-08-22",
   "power_source": [
     "battery",
     "ac-mains"
@@ -94,5 +94,14 @@
   },
   "environment": [
     "outdoor"
+  ],
+  "community_notes": [
+    {
+      "note": "go2rtc opens the Dahua two-way-audio backchannel by default, which can disrupt the doorbell's button/chime. Append #backchannel=0 to the go2rtc stream URL for normal behavior; #backchannel=1 enables two-way audio (needs extra setup).",
+      "category": "frigate",
+      "source": "https://github.com/ch-bas/cctv-camera-database/issues/301",
+      "reported_by": "ch-bas",
+      "date": "2026-08-22"
+    }
   ]
 }

cameras/hikvision/ds-2cd2387g2-lu.json

@@ -116,5 +116,14 @@
   },
   "environment": [
     "outdoor"
+  ],
+  "community_notes": [
+    {
+      "note": "Substream lives at /Streaming/Channels/102 (main is /101), which isn't in the datasheet. Frigate/go2rtc also needs the camera set to RTSP Authentication digest/basic with Digest Algorithm MD5, or the stream fails to open.",
+      "category": "rtsp",
+      "source": "https://docs.frigate.video/configuration/camera_specific/",
+      "reported_by": "ch-bas",
+      "date": "2026-08-22"
+    }
   ]
 }

cameras/reolink/e1-zoom.json

@@ -102,5 +102,14 @@
   "ptz": {
     "onvif_ptz": "absolute",
     "autotracking": true
-  }
+  },
+  "community_notes": [
+    {
+      "note": "For Reolink, the HTTP-FLV streams tend to be more reliable in Frigate than RTSP (which can stall / throw non-monotonic-timestamp errors); go2rtc can use the http source and add a secondary RTSP stream only for audio.",
+      "category": "rtsp",
+      "source": "https://docs.frigate.video/configuration/camera_specific/",
+      "reported_by": "ch-bas",
+      "date": "2026-08-22"
+    }
+  ]
 }

cameras/sv3c/c25.json

@@ -104,5 +104,14 @@
   "last_verified": "2026-08-21",
   "environment": [
     "outdoor"
+  ],
+  "community_notes": [
+    {
+      "note": "go2rtc's native RTSP client hangs on this camera (live view spins forever); prefixing the URL with ffmpeg: (ffmpeg:rtsp://.../11) fixes it. Stream paths are /11 (main) and /12 (sub), not the /stream0 & /stream1 shown in older docs.",
+      "category": "rtsp",
+      "source": "https://github.com/ch-bas/cctv-camera-database/issues/300",
+      "reported_by": "ch-bas",
+      "date": "2026-08-22"
+    }
   ]
 }