Skip to content

tphakala/birdnet-go

Repository files navigation

BirdNET-Go

BirdNET-Go is an AI solution for continuous avian monitoring and identification

  • 24/7 realtime bird song analysis of soundcard capture, analysis output to log file, SQLite or MySQL
  • Utilizes BirdNET AI model trained with more than 6500 bird species
  • Local processing, Internet connectivity not required
  • Easy to use Web user interface for data visualisation
  • BirdWeather API integration
  • Realtime log file output can be used as overlay in OBS for bird feeder streams etc.
  • Minimal runtime dependencies, BirdNET Tensorflow Lite model is embedded in compiled binary
  • Provides endpoint for Prometheus data scraping
  • Runs on Windows, Linux and macOS
  • Low resource usage, works on Raspberry Pi 3 and equivalent 64-bit single board computers

Help Improve BirdNET-Go

I am seeking web developer with experience in Go HTML templating, Tailwind CSS, HTMX, Alpine.js, or similar frameworks to join in enhancing the BirdNET-Go application web UI. Your expertise can make a real difference in how users engage with this app and connect with birdlife. If you have the skills and a keen interest in contributing to a nature-focused project, I'd love to hear from you.

Web Dashboard

Installation

For detailed installation instructions, see theinstallation documentation.

Building

For instructions on how to build the project, see thebuilding documentation.

Usage

BirdNET-Go CLI

Usage:
birdnet [command]

Available Commands:
authors Print the list of authors
completion Generate the autocompletion scriptforthe specified shell
directory Analyze all*.wav filesina directory
file Analyze an audio file
helpHelp about anycommand
license Print the license of Go-BirdNET
realtime Analyze audioinrealtime mode

Flags:
--debug Enable debug output
-h, --helphelpforbirdnet
--locale string Set the localeforlabels. Accepts full name or 2-letter code. (default"finnish")
--overlap float Overlap value between 0.0 and 2.9
--sensitivity float Sigmoid sensitivity value between 0.0 and 1.5 (default 1)
--threshold float Confidency thresholdfordetections, value between 0.1 to 1.0 (default 0.8)

Use"birdnet [command] --help"formore information about a command.

There is more detailed usage documentation at wikihttps://github /tphakala/birdnet-go/wiki

License

Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International

Authors

Tomi P. Hakala

Contributions by Hampus Carlsson, Jan Vrska, @twt--, @aster1sk, @hoover67

Please let me know if you are missing from contributors list!

BirdNET AI model by the K. Lisa Yang Center for Conservation Bioacoustics at the Cornell Lab of Ornithology in collaboration with Chemnitz University of Technology. Stefan Kahl, Connor Wood, Maximilian Eibl, Holger Klinck.

BirdNET label translations by Patrick Levin for BirdNET-Pi project by Patrick McGuire.