Files
AvianVisitors/README.md
T
Patrick McGuire b1df67183f Update README.md
2021-12-26 09:47:11 -05:00

5.8 KiB

BirdNET-Pi

A realtime acoustic bird classification system for the Raspberry Pi 4B

Icon made by Freepik from www.flaticon.com

Introduction

The BirdNET-Pi project is built on the TFLite version of BirdNET by @kahst using pre-built TFLite binaries by @PINTO0309 . It is able to recognize bird sounds from a USB sound card in realtime.

Check out birds from around the world

Currently listening in these countries . . . that I know of . . .

  • The United States
  • Germany
  • South Africa
  • France
  • Austria
  • Sweden

If your installation isn't in one of the countries listed above, please let me know so that I can add your country to the list! Let me know either in a GitHub issue, or email me and let me know where your BirdNET-Pi is listening.

Features

  • 24/7 recording and BirdNET-Lite analysis
  • Web interface access to all data and logs
  • Automatic extraction of detected data (creating audio clips of detected bird sounds)
  • Spectrograms available for all extractions
  • BirdWeather integration (you will need to be issued a BirdWeather ID -- for now, request that from @timsterc here)
  • MariaDB integration
  • NoMachine remote desktop (for personal use only)
  • Live audio stream
  • Integrated phpSysInfo
  • New species mobile notifications from Pushed.co (for iOS users only)
  • Localisation supported

Requirements

  • A Raspberry Pi 4B
  • An SD Card with the 64-bit version of RaspiOS installed (please use Bullseye) (download the latest here)
  • A USB Microphone or Sound Card

Installation

Headless installation guide available HERE
Pre-installeld beta image available for testing HERE

The system can be installed with:

curl -s https://raw.githubusercontent.com/mcguirepr89/BirdNET-Pi/main/newinstaller.sh | bash

Access

The BirdNET-Pi system can be accessed from any web browser on the same network:

Access Credentials:

  • Username:birdnet
  • Password: The "CADDY_PWD" password set during installation

Uninstallation

/usr/local/bin/uninstall.sh && cd ~ && rm -drf BirdNET-Pi

Troubleshooting and Ideas

I want this to work for you! If you have any trouble, or if my documentation is wrong, I'd like to get things right.

If you encounter any issues at any point, or have questions, comments, concerns, ideas, or want to share something, please take a look through the open and closed issues and the community discussions. PLEASE feel invited to open a new issue if you don't find the help you need. Likewise, please accept my invitation to start a new discussion to get a conversation started around your topic.

If you are not a GitHub user and need help, you can email me, but I hope you will consider making a GitHub account so that your questions can be answered here for others as well. I expect this project will attract more bird-enthusiasts than Linux-enthusiasts, so please don't feel like any question is too novice or, pardon the phrase, stupid to ask. I want to help!

Sharing

Please join a Discussion!! and please join BirdWeather!! I hope that if you find BirdNET-Pi has been worth your time, you will share your setup, results, customizations, etc. HERE and will consider making your installation public.

ToDo, Notes, and Coming Soon

Internationalization:

The bird names are in English by default, but other localized versions are available. Please download the labels_l18n.zip file and replace the model/labels.txt with the corresponding language.

Realtime Analysis Predictions View

The pre-built TFLite binaries for this project also support the BirdNET-Demo, which I am currently testing for integration into the BirdNET-Pi. If you know anything about JavaScript and are willing to help, please let me know in the Live Analysis discussion.

Tips:

For some reason, the system seems to run more efficiently and the birds sound better when you Star on GitHub the project :)