BirdNET-Pi 开源项目使用教程

BirdNET-Pi 开源项目使用教程

BirdNET-Pi A realtime acoustic bird classification system for the Raspberry Pi 4B, 3B+, and 0W2 built on the TFLite version of BirdNET. 项目地址: https://gitcode.com/gh_mirrors/bi/BirdNET-Pi

1. 项目的目录结构及介绍

BirdNET-Pi 项目是一个实时声学鸟类分类系统，适用于 Raspberry Pi 4B、3B+ 和 0W2。项目的目录结构如下：

BirdNET-Pi/
├── .github/
├── .gitignore
├── LICENSE
├── README.md
├── __init__.py
├── birdnet.conf-defaults
├── newinstaller.sh
├── requirements.txt
├── tflite_runtime-2.6.0-cp39-none-linux_aarch64.whl
├── version.md
├── model/
├── scripts/
├── templates/
├── tests/
└── -/

• .github/：包含 GitHub 的一些配置文件。
• .gitignore：定义了 Git 忽略的文件和目录。
• LICENSE：项目的许可证文件。
• README.md：项目的说明文件，包含了项目的介绍和使用方法。
• __init__.py：Python 包的初始化文件。
• birdnet.conf-defaults：项目的默认配置文件。
• newinstaller.sh：项目安装脚本。
• requirements.txt：项目依赖的 Python 包列表。
• tflite_runtime-2.6.0-cp39-none-linux_aarch64.whl：TensorFlow Lite 运行时。
• version.md：项目版本信息。
• model/：包含模型文件和相关的机器学习数据。
• scripts/：包含项目运行时需要的脚本文件。
• templates/：包含了项目使用的模板文件。
• tests/：包含项目的测试代码。

2. 项目的启动文件介绍

项目的启动文件是 newinstaller.sh 脚本。该脚本用于在 Raspberry Pi 上安装和配置 BirdNET-Pi 系统。运行该脚本的命令如下：

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

该脚本会自动执行以下步骤：

• 更新系统包。
• 安装项目依赖。
• 配置项目环境。

安装完成后，会生成一个安装日志文件，位于 $HOME/installation-$(date "+%F").txt。

3. 项目的配置文件介绍

项目的配置文件是 birdnet.conf-defaults。该文件包含了 BirdNET-Pi 的默认配置设置，包括但不限于以下内容：

• 数据库设置：指定数据库文件的存储位置。
• 模型设置：指定使用的 TensorFlow Lite 模型文件。
• 录音设置：指定录音设备和录音参数。
• 网络设置：指定网络接口和相关参数。

用户可以根据自己的需求修改 birdnet.conf-defaults 文件中的配置项，以适应不同的使用环境。配置文件的具体内容如下：

[database]
path = /home/pi/BirdNET-Pi/db

[model]
path = /home/pi/BirdNET-Pi/model

[recording]
device = plughw:1,0
format = S16LE
rate = 44100
channels = 1

[web]
port = 8080

确保修改配置文件后，重启 BirdNET-Pi 服务以应用新的设置。

BirdNET-Pi A realtime acoustic bird classification system for the Raspberry Pi 4B, 3B+, and 0W2 built on the TFLite version of BirdNET. 项目地址: https://gitcode.com/gh_mirrors/bi/BirdNET-Pi