A live bird collage card for your Home Assistant dashboard.
Docs: RTSP cameras as bird mics + recommended analysis settings (#16)
Adam Oberleya52e293927b5
diff --git a/README.md b/README.mdindex 18210a72..9c74fba0 100644--- a/README.md+++ b/README.md@@ -67,8 +67,11 @@ Home Assistant + BirdNET-Go.exist on these install types. Container/Core installs can still use the card; run[BirdNET-Go](https://github.com/tphakala/birdnet-go) yourself (e.g. inDocker) and skip to [Step 3](#step-3--install-the-card).-- **A microphone** the Home Assistant machine can hear birds with - a cheap- USB lavalier mic in a window works great.+- **Something that can hear birds.** If you already have an outdoor+ camera with a microphone - a doorbell, a security cam, an NVR - you're+ done: BirdNET-Go listens to RTSP streams, so the camera you own becomes+ the bird mic for free (Step 2 has the details). Otherwise a cheap USB+ lavalier mic in a window works great.- About **20 minutes**.The whole setup is: install the BirdNET-Go app (the thing that listens and@@ -103,12 +106,44 @@ community repository, which you add once:1. Open the BirdNET-Go web UI at `http://<your-ha-host>:8080` (there's alsoan **Open Web UI** button on the app page).-2. In BirdNET-Go's **Settings**, set your **latitude/longitude** (so it- knows which species are plausible) and pick your **audio capture- device** - your USB mic should be listed.-3. Wait for a bird (or play birdsong from your phone near the mic) and+2. In BirdNET-Go's **Settings**, set your **latitude/longitude** so it+ knows which species are plausible.+3. Give it ears - either works, and you can mix several:++ **An outdoor camera you already own (recommended).** Doorbell and+ security cameras have microphones, and BirdNET-Go listens to RTSP+ streams directly - no new hardware. In BirdNET-Go's audio settings add+ an **RTSP stream** per camera: give it a name (it becomes that mic's+ device name in HA, e.g. "Door Bell") and the camera's RTSP URL. Two+ things to check on the camera side: **audio recording must be enabled**+ in the camera's own settings, and use the low-resolution **sub stream**+ - BirdNET-Go only wants the audio, no point pulling main-stream video.++ For Reolink cameras behind an NVR the URL template is:++ ```+ rtsp://admin:[email protected]:554/h264Preview_01_sub+ ```++ (`_01_` is the camera's channel number on the NVR - `_02_`, `_03_`...+ for the rest; standalone Reolink cameras use the camera's own IP.)+ Other brands publish similar RTSP paths - search "<brand> RTSP URL".++ **Or a USB microphone** plugged into the HA machine - pick it as the+ audio capture device.++4. Wait for a bird (or play birdsong from your phone near the mic) andconfirm detections appear on BirdNET-Go's own dashboard.+**Tuning detections** - defaults are conservative; a starting point that+has worked well in practice is **Settings → Analysis**: Confidence+Threshold **0.7**, with Dynamic Threshold enabled, Trigger **0.9** and+Minimum **0.5**. (Dynamic threshold temporarily lowers the bar for a+species right after a high-confidence detection of it, so the quieter+follow-up calls of a bird that's clearly present still get logged without+letting random noise in.) It pairs nicely with this card's sit/fly rule -+confident detections perch, borderline ones fly past.+Don't move on until BirdNET-Go is detecting - this card is only a prettierwindow onto that data.