企业官网建设流程全解析

Fugleramme安装教程：从空白SD卡到实时鸟类识别相框只需4步

【免费下载链接】fuglerammeBird frame for Raspberry Pi - real-time bird detection by audio, fully local AI, rendered as real, hand-cut 1800s bird illustrations. On an e-ink panel, a TV, or any screen.项目地址: https://gitcode.com/gh_mirrors/fu/fugleramme

Fugleramme 是一个基于树莓派（Raspberry Pi）的实时鸟类识别相框：麦克风拾音 + 全本地 AI 检测鸟鸣，再把识别出的鸟"画"成 19 世纪复古手绘鸟类图鉴，显示在电子墨水屏、电视或任何屏幕上。整个过程完全离线运行，不需要联网 API，也不需要编程经验。本教程带你从一张空白 SD 卡开始，用 4 个步骤装好这个 Fugleramme 鸟类识别相框。

Fugleramme 是什么？把鸟鸣变成复古鸟类图鉴

它的原理其实很简单：BirdNET-Go 负责监听麦克风并做鸟声分类（完全在本地运行），Fugleramme 定期轮询它的 API，把每种识别到的鸟匹配到一张真实手工裁剪的老式鸟类版画插图上，拼成一页"纸质"图鉴，鸟类出现时自动重绘。

花园安静时只显示一根空栖枝；来客越多，图鉴越热闹：

还没有鸟	几位访客	热闹的花园

💡 电子墨水屏让它看起来像真正的相框，但它不是必须的——没有墨水屏时，它也能跑在电视、HDMI 显示器甚至桌面壁纸上，详见 docs/screens.md。

开始之前：树莓派鸟类识别相框硬件清单

完整的推荐配置（docs/hardware.md）：

麦克风是最值得花钱的部件——识别准确率很大程度上取决于它。如果你只想先看效果，也可以跳过整套硬件，用 Docker 容器 在任何 Linux 机器上跑。

第 1 步：把 Raspberry Pi OS 写入空白 SD 卡

用官方工具Raspberry Pi Imager烧录系统，注意这 4 个设置：

1. 系统选择Raspberry Pi OS Lite（64 位），Trixie 或更新版本（需要支持 USB Gadget 模式）。Lite 版省内存；只有想直接用 HDMI 屏幕显示相框时才选桌面版。
2. 设置主机名（例如fugleramme）和用户名（例如admin）。
3. 开启 SSH（后面远程登录要用）。
4. 配置Wi-Fi（或之后插网线）。

烧录完成后，把 SD 卡插入树莓派，接上电源即可。

第 2 步：SSH 远程登录树莓派

在你的电脑终端里，通过 Wi-Fi 或以太网登录：

ssh admin@fugleramme.local

能登录就说明系统写好了。没有 Wi-Fi 环境？可以启用 USB Gadget 模式，用 USB-C 线直连电脑（见第 4 步）。

第 3 步：一条命令安装 Fugleramme 实时鸟类识别

克隆仓库并运行安装脚本（install.sh）：

git clone https://gitcode.com/gh_mirrors/fu/fugleramme cd fugleramme bash install.sh

安装器会先询问再动手，主要问三件事：

• 你已经有 BirdNET-Go 了吗？没有的话（默认），它会用 Docker 在树莓派上把 BirdNET-Go 一起装好；如果已经跑在别的机器上，填它的地址（如http://birdnet.local:8080）即可。
• 端口：相框网页界面默认8080，BirdNET-Go 默认8090。被占用的端口会自动换到下一个空闲端口。
• 是否重启：脚本会启用 SPI 和 I2C 接口（驱动墨水屏用），装完会要求重启——放心重启，一切会自动恢复。

懒人模式（全部采用默认选项）：

bash install.sh -y

装好后，Fugleramme 会注册为 systemd 服务开机自启（服务定义见 src/fugleramme/service.py），在:8080提供相框页面，管理后台在:8080/admin（src/fugleramme/web/admin.py），之后可以随时修改显示内容和端口。

第 4 步（可选）：开启 USB Gadget 模式

这一步让你不用 Wi-Fi 也能维护相框：用一根 USB-C 线把树莓派插到电脑上，就能直接 SSH 进去——换新安装位置、换 Wi-Fi 时特别好用。安装脚本在第 3 步询问过是否开启，默认接受即可。

Pi 5 需要手动更新一次引导加载程序：

sudo rpi-eeprom-update -a sudo rpi-eeprom-config -e # 加一行：PSU_MAX_CURRENT=3000 sudo reboot

PSU_MAX_CURRENT=3000让树莓派能被笔记本通过同一根 USB-C 线正常供电。之后把线插到电脑、按需开启系统的"网络共享"，就能离线连上了。

安装完成后：配置麦克风与鸟鸣识别

如果 Fugleramme 帮你装了 BirdNET-Go，还要告诉它声音从哪里进来（详见 docs/birdnetgo-config.md）：

1. 打开 BirdNET-Go 面板http://<主机名>.local:8090；
2. 进入Settings → Audio，点 "Add Sound Card" 添加你的声卡设备，保存即可；

3. 设置你的地理位置（强烈推荐）——位置和时间会影响模型判断哪些鸟更可能出现：

项目自带一份合理的初始检测配置模板（detector/config/config.yaml.template），首装自动生效，后续可随时在面板里调整灵敏度，减少误报。

在哪里看效果：电子墨水相框、电视、电脑桌面

相框页面就是一个网页，五种显示方式任选（docs/screens.md）：

• 电子墨水屏：A4 尺寸，直接放进 A4 相框，就是真正的"鸟类相框"；
• 三星 Frame 电视 / 任意 HDMI 屏幕：浏览器全屏打开http://<主机名>.local:8080/即可，效果非常惊艳：

• 手机 / 平板 / 笔记本：同一局域网内直接打开页面；
• 电脑桌面壁纸 / 屏保（macOS 支持"照片"文件夹源）：

常见问题与下一步

• 屏幕没反应？先查 docs/troubleshooting.md；
• 想改端口 / 显示模式？看管理后台或 docs/operations.md；
• 完整安装文档：docs/install.md；更多玩法：docs/faq.md、docs/showcase.md。

🦅 恭喜，你的实时鸟类识别相框已经装好了——等清晨第一声鸟鸣，它会自己"画"出来。

【免费下载链接】fuglerammeBird frame for Raspberry Pi - real-time bird detection by audio, fully local AI, rendered as real, hand-cut 1800s bird illustrations. On an e-ink panel, a TV, or any screen.项目地址: https://gitcode.com/gh_mirrors/fu/fugleramme