June 9th, 2024 release

[0.5.5] - 2024-06-09

🚀 Features

• (audio) Support for multiple RTSP streams
• (birdnet) Range filter model is now selectable between latest and previous "legacy" version
• (birdnet) Added "birdnet-go range print" command which lists all species included by range filter model
• (birdnet) BirdNET overlap setting impacts now realtime process also

🐛 Bug Fixes

• (privacy) Fix defaults for privacy and dog bark filters and fix incorrect setting names in default config.yaml
• (privacy) Do not print dog bark detections if dog bark filter is not enabled
• (privacy) Fix printf declaration for human detection confidence reporting
• (audio) Yield to other goroutines in file_utils, policy_age, and policy_usage
• (build) Linux/arm64 cross-compilation in docker build

🚜 Refactor

• (audio) Refactor analysis and capture buffers to support multiple individual buffers for different audio sources
• (audio) Move RTSP code to rtsp.go
• (config) Config file format for range filter model changed due model type option
• (rtsp) Update default RTSP URLs to an empty slice
• (rtsp) Update RTSP stream URLs example in config.yaml
• (privacy) Make pricacy filter and dog bark filter source specific
• (build) Move buildDate variable to main.go

🏗️ Building

• (deps) Bump github.com/spf13/viper from 1.18.2 to 1.19.0
• (deps) Bump github.com/shirou/gopsutil/v3 from 3.24.4 to 3.24.5

v0.5.4

[0.5.4] - 2024-06-01

🚀 Features

• (audio) Disk usage based audio clip retention policy, enabled by default with 80% disk usage treshold
• (conf) Privacy filter Confidence threshold setting
• (conf) Dog bark filter Confidence threshold setting
• (conf) Dog bark filter time to remember bark setting

🐛 Bug Fixes

• (webui) Fix Settings interface load error

🚜 Refactor

• (conf) Refactor configuration package to improve settings handling, easier access to settings in code
• (audio) Audio clip retention policy setting: none, age, usage
• (audio) Age base audio clip retention policy accepts time in days, weeks, months and years instead of hours
• (conf) Many settings renamed

⚙️ Miscellaneous Tasks

• Update go.mod with github.com/mitchellh/mapstructure v1.5.0

May 23rd, 2024 release

[0.5.3] - 2024-05-21

🚀 Features

• (birdweather) Added location fuzzing support for BirdWeather uploads, requires support for BirdWeather.com
• (audio) Audio source device is now user configurable

🐛 Bug Fixes

• (audio) Audio clip extraction fixed for occassional non-contiguous clips

🚜 Refactor

• (conf) Move default config file from .go to .yaml and add proper default value initialization
• (conf) Update audio export settings in updateconfig.go and realtime.go

🏗️ Building

• (deps) Bump golang.org/x/text from 0.14.0 to 0.15.0
• (deps) Bump golang.org/x/crypto from 0.22.0 to 0.23.0
• (deps) Bump github.com/prometheus/client_golang

⚙️ Miscellaneous Tasks

• Update go version to 1.22.3
• Update golang version to 1.22.3
• Bump HTMX version from 1.9.11 to 1.9.12
• Bump daisyUI to 4.11.1
• Update custom.css to fix theme controller styles
• Update tailwindcss to v3.4.3
• Hide "Detections" column on smaller screens
• Update audio buffer initialization in realtime analysis
• Remove unused import and struct field in audiobuffer.go

May 1st, 2024 release

[0.5.2] - 2024-05-01

🚀 Features

• Prometheus metrics support, endpoint reports BirdNET detections and application Golang runtime metrics - contributed by @aster1sk
• Disk management by old audio capture cleanup - contributed by @isZumpo

🐛 Bug Fixes

• (analysis) File analysis restored
• (capture) Improve audio buffer write function time keeping
• (datastore) Refactor datastore Get, Delete and Save methods for efficient transaction and error handling
• (datastore) Refactor GetClipsQualifyingForRemoval method in interfaces.go for improved input validation and error handling
• (birdweather) Improve handling of HTTP Responses in UploadSoundscape to prevent possible panics
• (birdweather) Fixed PCM to WAV encoding for soundscape uploads
• (birdweather) Increase HTTP timeout to 45 seconds
• (utils) Do not report root user as missing from audio group
• (tests) Refactor createDatabase function in interfaces_test.go for improved error handling

💄 Enhancement

• (audio) Print selected audio capture device on realtime mode startup
• (startup) Enhance realtime mode startup message with system details to help troubleshooting

🚜 Refactor

• (conf) Remove unused Context struct from internal/conf/context.go
• (processor) Update range filter action to handle error when getting probable species

🏗️ Building

• (deps) Bump golang.org/x/crypto from 0.21.0 to 0.22.0
• (deps) Bump google.golang.org/protobuf from 1.32.0 to 1.33.0
• (deps) Bump golang.org/x/net from 0.21.0 to 0.23.0
• (go) Bump Go version from 1.21.6 to 1.22.2 in go.mod
• (deps) Bump labstack echo version from 4.11.4 to 4.12.0
• (deps) Bump gorm.io/gorm from 1.25.9 to 1.25.10
• (deps) Bump github.com/gen2brain/malgo from 0.11.21 to 0.11.22

⚙️ Miscellaneous Tasks

• Fix linter errors

Github

• (workflow) Add tensorflow dependencies to golangci-lint

April 5th, 2024 release

[0.5.1] - 2024-04-05

🚀 Features

• MQTT publishing support, contribution by @janvrska
• Location filter threshold is now configurable value under BirdNET node

🏗️ Building

• (deps) Bump gorm.io/gorm from 1.25.8 to 1.25.9

v0.5.0

Changelog

v0.5.0

🚀 Features

• (ui) Web UI for data visualization
• (detection) Privacy filter to discard audio clips with human vocals
• (detection) Dog bark tracking for common false positive filtering
• (db) Save all BirdNET prediction results into table Results
• (audio) Check user group membership on audio device open failure and print instructions for a fix
• (docker) Added support for multiplatform build
• (conf) New function to detect if running in container
• (audio) rtsp audio stream capture support by @twt--

🐛 Bug Fixes

• (docker) Install ca-certificates package in container image
• (capture) Set capture start to 5 seconds before detection instead of 4 seconds
• (capture) Increase audio capture length from 9 to 12 seconds
• (rtsp) Wait before restarting FFmpeg and update parent process on exit to prevent zombies

💄 Enhancement

• (database) Switched sqlite journalling to MEMORY mode and added database optimize on closing
• (workflow) Update GitHub Actions workflow to build and push Docker image to GHCR
• (workflow) Support multiplatform build with github actions
• (docker) Add ffmpeg to container image
• (ui) Add Greek (el) translations by @hoover67
• (ui) Improve spectrogram generation to enable lazy loading of images

🚜 Refactor

• (ui) Improved spectrogram generation
• (database) Move save to common interface and change it to use transaction
• (audio) Stopped audio device is now simply started again instead of full audio context restart
• (audio) Set audio backend to fixed types based on OS, default to ALSA on Linux
• (labels) Update makefile to zip labels.zip during build and have label files available in internal/birdnet/labels to make it easier to contribute language updates
• (audio) Improve way start time of audio capture is calculated

📚 Documentation

• (capture) Add documentation to audiobuffer.go
• (changelog) Add git-cliff for changelog management

🏗️ Building

• (deps) Add zip to build image during build
• (deps) Bump gorm.io/driver/mysql from 1.5.4 to 1.5.6
• (deps) Bump gorm.io/gorm from 1.25.7 to 1.25.8
• (docker) Add docker build workflow by @isZumpo

⚙️ Miscellaneous Tasks

• (assets) Upgrade htmx to 1.9.11

Github

• (workflow) Add workflow for building releases
• (workflow) Updated windows build workflow

BirdNET-Go 20240215 snapshot

BirdNET-Go 20240215 development snapshot

This is first binary release which contains web interface for realtime detection data visualization. Web UI is accessible with http on port 8080/tcp when BirdNET-Go is running in realtime mode.

• birdnet-go_snapshot_20240215_arm64.tgz is compiled for RPI 3, RPI 4 and RPI 5

BirdNET-Go v0.4.4

• BirdNET meta model support for location based species filtering
• BirdWeather support
• Species specific threshold support
• Lots of small fixes

Archive contains pre-compiled libtensorflow_c.so library, copy this file on Linux systems to /usr/local/lib and run ldconfig.
For Windows version libtensorflowlite_c.so needs to be in a directory included in PATH.

Please see detailed documentation at https://github.com/tphakala/birdnet-go/wiki

gobirdnet_v0.4.4_linux_arm64 is tested to run on Raspberry Pi 3B+, 4 with Bulleseye and 5 with Bookworm
gobirdnet_v0.4.4_linux_amd64 is tested to run on Debian 11 and Ubuntu 23.10 Intel
gobirdnet_v0.4.4_windows_amd64 is tested to run on Windows 11 Intel

Go-BirdNET v0.3.0

• Supports 48khz WAV file processing
• Supports realtime audio processing from soundcard source
• BirdNET tflite model and labels are now embedded in binary reducing runtime dependencies
• Two new output types, Raven table which is default and csv, output is stored in directory specified by --output or -o flag
• Directory processing mode, "birdnet directory my-sound-files" processes all wav files in that directory, supports recursing with --recursive or -r flag
• Set prediction confidence threshold with --threshold flag, value range 0.0 - 1.0

Archive contains pre-compiled libtensorflow_c.so library, copy this file on Linux systems to /usr/local/lib and run ldconfig.
For Windows version libtensorflowlite_c.so needs to be in a directory included in PATH.
For macOS version copy libtensorflowlite_c.dylib to /usr/local/lib.

gobirdnet_v0.3.0_linux_arm64 is tested to run on Raspberry Pi 4 with 64-bit Raspberry Pi OS Bullseye
gobirdnet_v0.3.0_linux_amd64 is tested to run on Debian 11 and Ubuntu 23.10 Intel
gobirdnet_v0.3.0_windows_amd64 is tested to run on Windows 11 Intel
gobirdnet_v0.3.0_darwin_amd64 is tested to run on macOS 14.1 Intel

Go-BirdNET v0.2.1

Supports WAV file analysis and real time audio capture analysis.

Real time capture detections are logged in ./log/detections.log file which can be used for example as chatlog overlay for birdfeeder streams in OBS. Real time mode also saves detections exceeding set confidence threshold as WAV files to ./clips directory.

File analysis supports only 48000 Hz input files, bit depth can be 16, 24 or 32 bit integer type.

Archive contains pre-compiled libtensorflow_c.so library which should be copied on Linux systems to system LDPATH, on Windows it works from directory you extracted birdnet.exe to.