github tphakala/birdnet-go 20261122
BirdNET-Go 20261122

one hour ago

This release brings the stable BirdNET+ v3.0 release to the model gallery (global plus 44 regional models), a redesigned single-page detection view with per-classifier results, species correction, and keyboard shortcuts, built-in clip denoising for saved clips and live playback, and a "Remember this browser" sign-in option so active users stay logged in. It also adds the experimental BSG-BAT European bat model alongside an improved bat detection post-filter, brings OpenVINO support to Windows, makes OIDC sign-in easier to configure and troubleshoot, reorganizes the Analysis settings, and delivers a major accessibility pass across the web UI.

Before you upgrade

  • If you use authentication, you will need to sign in once. BirdNET-Go now tracks logins with server-side sessions, so existing browser sessions from earlier versions are not carried over. If authentication is enabled on your station, each browser will need to sign in again after upgrading (installs running on a local LAN without authentication are unaffected). The old security.sessionduration and security.basicauth.accesstokenexp settings no longer control how long a browser stays signed in; if you customized them, you will see a startup warning (safe to ignore or remove from your config) (#5239).
  • MP3 clip export is discouraged. MP3 is a very old audio compression format with known performance issues when exporting clips. If you currently export clips as MP3, switching to a more modern format such as AAC or Opus is recommended instead. System Health now shows a hint whenever MP3 clip export is configured (#5237).
  • Perch v2 regional models: check your confidence threshold. Regional Perch v2 models previously produced inflated scores because they were scaled only against local species instead of the full global list. They now use the same scale as the global model, which cuts down high-scoring false positives. If you tuned a threshold on a regional Perch v2 model, it is now stricter, so check your detection rate after upgrading and lower the threshold if needed (#5014).
  • Perch v2 int8-arm builds have been removed from the gallery. These compressed ARM builds disagreed with the full-precision model too often on real audio. If you already have one installed, it will keep working until you uninstall it; otherwise, the gallery now recommends the full-precision (fp32) build for your region (#5172).
  • Raspberry Pi and ARM64 hosts now default to ONNX Runtime. With birdnet.backend: auto, ARM64 systems now run models on ONNX Runtime instead of OpenVINO CPU, saving 114 to 166 MB of memory per model with equal or better speed. On OpenVINO CPU, BirdNET v2.4 now always runs at full precision because half-precision mode missed detections during wind and low-frequency noise. No action is needed unless you specifically want OpenVINO CPU, in which case set birdnet.backend: openvino (#5059, #5069).
  • Custom ONNX Runtime installs need version 1.31 or newer. Docker images and official release packages already bundle ONNX Runtime 1.32.0, so most users do not need to do anything. If you supply your own ONNX Runtime library and still run 1.29 or 1.30, BirdNET-Go will report it as unavailable and link to the install guide (#5038, #5144).
  • API changes for custom integrations. GET /api/v2/health no longer includes raw database_error text, and GET /api/v2/models now returns plain model names without a backend suffix, moving backend details into separate backend, precision, and state fields (#5043, #5176, #5177).

New Features

BirdNET+ v3.0

BirdNET+ v3.0, the stable release of BirdNET v3.0, is now available in the model gallery under the Apache-2.0 license. It ships as one global model and 44 regional models (including a new Central India region), covering 11,709 species and 16 non-animal sound classes.

  • Faster build 3.0.1 out of the box. The gallery offers build 3.0.1, which runs about 13 to 17% faster on a Raspberry Pi 5 and roughly twice as fast on Intel GPUs compared to 3.0, while fixing wrong predictions on very loud audio near clipping. ONNX Runtime is the recommended backend.
  • Regional updates and domestic animals. Regional models now receive build updates directly, and current builds include domestic dogs and other domestic animals.
  • Built-in location filtering and license prompt. Installing BirdNET+ v3.0 displays its verified acceptable use policy in the install dialog and automatically installs BirdNET Geomodel v3.0 for range filtering.
  • Smooth upgrade from the Developer Preview. If you installed the earlier BirdNET v3.0 developer preview, it keeps working and remains installable, while the gallery marks it as superseded and sends a bell notice recommending you switch to BirdNET+ v3.0. Species renamed in the new label set (such as Eurasian Wren and Reed Bunting) are automatically matched to their established range-filter names and receive their real eBird codes (#5160, #5162, #5164, #5166, #5167, #5168, #5170, #5196, #5198, #5199, #5200, #5201, #5203, #5204, #5223, #5260).

Redesigned Detection Details Page

Everything about a detection now lives on one page with no tabs to click through. On large databases, the page also loads much faster because it no longer fetches statistics for every species up front.

  • Everything at a glance. A navigation bar steps to the previous or next detection (across all species or just the same species). Dedicated cards show the species identity and review controls (Correct, False positive, Wrong species, Keep, Ignore species), a 24-hour sky strip with daylight, twilight, the sun's path, hourly species activity, and weather conditions, the audio player with a Download audio button, and 30-day species statistics with range-filter score, first/last heard dates, and warnings for frequently rejected species.
  • Per-classifier match details. A dedicated Models card now shows which classifier(s) matched on the detection and at what confidence values, along with hit counts and hit times, as well as any active models that ran and found nothing.
  • Reassign wrong species. Reviewers can now correct a misidentified detection by picking from the model's other predictions or searching either local range-filter species or the full species list. The model's original pick remains saved and visible after a change.
  • Keyboard shortcuts for faster review. Use the arrow keys to step between detections (hold Shift for the same species), c to mark Correct, f for False positive, w to change the species, k to toggle Keep, p or Space to play audio, and ? to open the shortcut cheat sheet (#4960, #4969, #4970, #5131, #5133, #5134, #5135, #5137, #5139, #5141, #5247).

Clip Denoising and Shared Playback Defaults

You can now clean up background noise in detection clips either permanently when saving or on the fly during playback, with a new light-medium strength (between light and medium) as the default for both.

  • Denoise saved clips. Enable Denoise Saved Clips under Settings > Audio > Processing (off by default) to clean clips before writing them to disk.
  • Denoise during playback and download. Enable Denoise clips when played under Settings > User Interface > Audio Playback to leave stored files untouched while denoising audio on the fly when played or downloaded in the web UI. The detection page displays the denoised spectrogram too, and audible bat copies follow the same choice.
  • Station-wide playback defaults. Every audio player now starts with the same station defaults for gain (expanded to -12 to 24 dB), denoising, and a new default high-pass filter, including for signed-out visitors. Change these defaults anytime from the new gear button on the player toolbar on the Detection and Search pages (#5064, #5067, #5068, #5074, #5076, #5077, #5105, #5261, #5267).

BSG-BAT European Bat Model (Experimental)

BSG-BAT, a classifier covering 21 European bat species under the CC-BY-4.0 license, is now in the model gallery. It is marked experimental while its real-world performance in BirdNET-Go is still being proven. It requires a microphone capture rate of at least 192 kHz, with 384 kHz recommended (species calling above 96 kHz cannot be identified at 192 kHz). You can adjust its confidence threshold and analysis step size under Settings > Analysis > Bats to trade detection rate for lower CPU usage on slower hosts (#5066, #5072, #5073, #5075, #5130).

Stay Signed In with "Remember This Browser"

The sign-in dialog now has a "Remember this browser" checkbox, ticked by default. Remembered browsers stay signed in for 30 days from their last use, and active users are no longer sent back to the login page every hour. Unchecking it ends the session when the browser closes. Signing out now survives a restart, and changing your password signs out every browser (#5239).

Model Gallery Improvements

  • Guided setup after install. After you install a classifier, a wizard offers to turn it on for all audio sources or for chosen sound cards and streams so new models do not sit unused (#5202).
  • Cancel downloads anytime. Model installs, updates, and swaps can now be cancelled while files are downloading without interrupting an already installed model (#5262).
  • One-click build updates with release notes. When a newer build of an installed model is published, a bell notice and the model card offer a one-click update and show the new build's release notes before it runs (#5224, #5263).
  • Easier-to-read cards and smarter defaults. Model descriptions can now be expanded instead of cutting off at two lines, cards share one consistent layout, and the install dialog no longer preselects another region's model when nothing is recommended for your host (#5129, #5174).

Reorganized Analysis Settings

Settings > Analysis has been regrouped around what each setting does so options are easier to find:

  • Cleaner tabs and threshold cards. Settings are organized into Detection, Filters, Bats, a new Inference tab (backend, OpenVINO device, and CPU threads limited to runtimes your host actually has, plus the runtime and precision each model uses), and Models. All detection thresholds are grouped in one card, and every card labels which classifiers it applies to.
  • Modernized controls and source editors. On/off settings across the settings pages now use toggle switches, cards have icons and clearer subgroup labels, and the sound card and stream editors are rebuilt as cards showing gain, classifiers, and quiet hours at a glance, with warnings when a selected model is missing or not loaded.
  • Database statistics moved. Database statistics now live under System > Database (#5184, #5185, #5197, #5213, #5214, #5215, #5217, #5225, #5235, #5254).

OpenVINO on Windows

Windows (amd64) users with an Intel CPU or GPU and an OpenVINO installation can now use the OpenVINO backend. Hosts with more than one Intel GPU (such as integrated graphics alongside an Intel Arc card) now detect them properly, and birdnet.openvinodevice accepts specific device IDs such as GPU.1 (#5209, #5210, #5212).

More New Features

  • Unsaved changes warning. Leaving a page with unsaved edits (settings, notification templates, alert rules, detection notes, and others) now asks before discarding your changes, including on reload or tab close (#5257, fixes #5216).
  • Improved bat post-filter with discard option. The bat detection post-filter has been improved so it produces fewer incorrect matches from non-bat noise (such as rain, rustling, and broadband clicks), while avoiding flagging genuine bat calls when echolocation activity is present. A new option under Settings > Analysis > Bats (off by default) also lets you automatically discard detections tagged as unlikely instead of keeping them (#5096, #5097, #5098, #5103).
  • Multi-model consensus filter (config file only). For setups running several models at once, an optional filter discards a detection unless enough models in the same group agree on it. It is off by default and configured via realtime.modelconsensus in config.yaml (no settings page yet) (#4974).
  • Geomodel health warning. System Health now warns you (and sends a notification) with the fix if BirdNET Geomodel v3.0 is missing, unselected, or fails to load when using Perch v2, BirdNET v3.0, or BirdNET+ v3.0 (#5142, #5221).
  • Cleaner System pages. The process table is now sortable and searchable, metric tiles fit at tablet widths, and System pages show a layout skeleton while loading (#5104, #5107, #5132).

Security

  • Accurate, proxy-safe rate limits. Rate limits for sign-in, live audio streams, and metrics streams now apply over their documented per-minute and 15-minute windows instead of per second. All API rate limits track verified client addresses (counting IPv6 clients per /64), so forged forwarded headers no longer bypass limits and one remote user behind a reverse proxy cannot exhaust everyone else's login allowance. Login and import elevation attempts are also limited per connection with bounded memory, the login dialog now tells you when attempts run out, and security logs record the matching client address (#4980, #4985, #5004, #5005, #5007, #5008, #5044, #5045, #5050, #5051, #5052, #5053).
  • Privacy and dog bark filters cover BirdNET v3.0. Human and dog labels in BirdNET v3.0 previously bypassed the privacy and dog bark filters because their labels include common names. Both filters now catch them (#5157).
  • OAuth and OIDC hardening. Sign-in always checks identities against the provider named in the URL instead of another provider's allowed users list. Blank or unknown provider IDs are refused on save so you cannot lock yourself out, identity provider requests now time out cleanly, URL credentials are redacted from errors and logs, and allowed users lists are no longer written to the security log (#5150, #5156, #5158, #5159, #5161).
  • Stricter CORS credentials. Cross-origin requests carrying login credentials are allowed only for explicitly listed origins, never for a wildcard (*) (#5015).
  • No database details on the public health endpoint. GET /api/v2/health no longer returns raw database error text that could expose hostnames or file paths (#5043).
  • Multipath TCP disabled. Multipath TCP is turned off on all network sockets for tighter network hardening (#5041).

Bug Fixes

Sign-in and OIDC

  • OIDC settings apply without a restart. Enabling OIDC, fixing an issuer URL, or rotating a secret now takes effect immediately on save (#5153).
  • Pasted discovery URLs just work. Entering the full /.well-known/openid-configuration URL as the issuer no longer causes a 404, and an issuer mismatch now triggers a warning (#5149).
  • Clearer OIDC troubleshooting. Discovery failures and skipped provider sign-out are logged to the console, and the login page explains why OIDC sign-in is unavailable instead of showing a raw error (#5145, #5151).
  • Sign-out works with HTTP issuers. Provider sign-out now works with http:// issuers, and an optional return URL brings you back to BirdNET-Go afterwards (#5171).
  • Case-insensitive provider IDs and URL checks. Provider IDs are now case-insensitive, and security.baseUrl is validated on save (#5152, #5169).

Models and Detection

  • Alternate predictions respect the range filter. Species outside your location's range are no longer stored as alternates (#4969).
  • Correct eBird codes for renamed species. Detections whose model label differs from the eBird name now receive the right eBird code (#5166, #5251 by @dhorkel).
  • Installed Geomodel always replaces the stock model. Installing BirdNET Geomodel v3.0 now takes precedence even when the range-filter model path still points to a stock MData file (#5206).
  • Geomodel registers immediately on install. Installing Perch v2 or BirdNET v3.0 now records BirdNET Geomodel v3.0 as installed right away instead of showing it as missing until a restart (#5207).
  • Live model lists in audio settings. Audio source editors now show each model with the backend it actually runs on and reflect installs, uninstalls, and load failures without a page reload (#5176, #5177).
  • db-doctor label repair. db-doctor now repairs orphaned labels only to labels belonging to the detection's actual model (#5136).

Bats

  • Ultrasonic filtering works at all sample rates. Bat validation now reads the right 20 kHz frequency split on microphones recording at rates other than 256 kHz, such as 192 kHz or 384 kHz (#5070).
  • Fewer false bat detections from noise, and fewer real ones flagged. Detections caused only by rain, rustling, or broadband clicks are now tagged unlikely, while real bat calls are only tagged unlikely when every triggering window lacks echolocation activity (#5096, #5098, #5103).

Audio & Streaming

  • Live Audio recovers after an RTSP drop. Live Audio now reconnects cleanly after an RTSP restart instead of replaying the last few seconds and freezing until the container is restarted (#5256, fixes #5255).
  • Processed audio matches replaced clips. Filtered and audible bat playback caches now update when a detection's clip is replaced instead of playing old audio (#5065).
  • Restart Analysis button now works. Clicking it previously accepted the request without actually restarting analysis (#4996).
  • Audio player polish. Playing a selected section applies gain and filters, the toolbar wraps at tablet widths instead of hiding Export, and the seek bar, settings popover, and toggle buttons work with keyboards and screen readers (#5081, #5146, #5148).

Database & Migration

  • Smooth migrations on large databases. Prerequisite checks now run in the background with progress instead of timing out after 30 seconds, SQLite integrity results are reused instead of rescanning on every visit, starting a migration no longer reruns slow checks, and System > Database shows why a migration cannot start along with errors that were previously swallowed (#4995, #4998, #5006, #5020, #5021, #5022).
  • Detections save reliably on busy disks. Periodic 5-minute table counts no longer hold the SQLite connection for up to 51 seconds on slow storage and cause detection saves to fail (#5027).
  • MySQL and MariaDB lock handling. Locking a detection twice at once no longer fails, and retries now run only on real lock and deadlock errors (#5138, #5140).
  • Clearer Windows database startup errors. Path and disk errors at startup now name the database path setting to check (#5241).

Imports

  • BirdNET-Pi audio is found automatically. Database and audio imports from a BirdNET-Pi installation or backup now locate clips in BirdSongs/Extracted/By_Date or in a By_Date folder next to birds.db (#4826 by @me0wl, fixes #4677, #5080 by @khmgj9572y-wq).

Logging

  • Much quieter debug logs. Repetitive per-inference, per-file, and per-detection lines are removed or moved to Trace level, shrinking debug logs and support dumps considerably. Trace entries now display as TRACE, and log deduplication defaults that older builds saved as disabled are restored (#5026, #5029, #5031, #5032, #5033).
  • No error-tracking noise from network failures. Network errors are no longer reported to error tracking (#5086).

Web UI & System

  • Reverse proxy sub-paths work everywhere. Live metrics streams, import progress, device capability checks, downloads, and navigation links now preserve your proxy path prefix (#5030 by @alexbelgium, fixes #5028).
  • No fake disks in containers. Single-file bind mounts such as /etc/hosts and NVIDIA driver files are no longer listed as storage disks (#4787 by @ParkWardRR).
  • "Expected today" works in early January. Early January lookups now compare against the previous year's December instead of the wrong year (#5042).
  • Accessibility improvements across the UI. Text and status colors meet WCAG AA contrast in every theme and color scheme, focus rings are full strength, dialogs return focus to the control that opened them, you can leave the System Terminal with Escape then Tab, every form field has a unique label, and sortable tables, radio groups, and the color scheme picker work with the keyboard (#5100, #5111, #5121, #5122, #5123, #5124, #5126, #5143, #5147, #5154, #5165, #5175, #5178, #5182).
  • Everyday UI polish. The browser tab title follows the current page, the theme follows your OS preference until you pick one, menus no longer wrap their labels, and the Database detection rate card fits cleanly at tablet widths (#5108, #5120, #5125, #5128, #5259).

🛡️ VirusTotal Results:

Don't miss a new birdnet-go release

NewReleases is sending notifications on new releases.