Fugleramme

项目简介

Fugleramme 是一个基于树莓派的电子墨水相框项目，它用「听」来代替「看」：通过麦克风实时监听窗外的鸟叫，用本地 AI 识别鸟种，再把这个物种匹配成一幅手工剪裁的 1800 年代博物学插画，显示在电子墨水屏上。它把「窗外的鸟」变成了墙上的一幅会变化的画。项目作者 arnegiacomo 把它装在自己位于挪威卑尔根的厨房窗户边，实时显示花园里正在鸣叫的鸟类，并把画面做成网页公开在线上。整条链路完全在本地运行，音频不上传云端，隐私友好，同时兼具复古插画的美感与实时感知的趣味。

核心功能

• 实时鸟类识别：借助麦克风采集环境声音，由本地分类器实时判断当前鸣叫的鸟种。
• 插画自动匹配：为每一种识别出的鸟匹配对应的历史博物学插画，并自动去背景处理。
• 智能排版绘制：把多只鸟打包到一张带纸张质感的页面上，体型越大的鸟越靠中心，尺寸按体重缩放；没有鸟时则显示一根空栖木。
• 仅在变化时重绘：只有当鸟类集合发生变化时才刷新电子墨水屏，符合墨水屏低刷新、低功耗的特性。
• 网页 Kiosk 同步视图：同一画面也通过网页形式提供服务，任何联网设备都能打开查看。
• 管理后台：提供配置页面，可自定义显示内容、更新策略等。
• 可复用现有识别服务：若已自行运行 BirdNET-Go，可直接把相框指向它，无论同机还是局域网内其他设备。

技术实现

项目的技术分工相当清晰。声音识别环节交由 BirdNET-Go 负责，它监听麦克风并完成鸟类分类，该项目作为独立容器单独安装，采用非商业许可。Fugleramme 本身则轮询 BirdNET-Go 的 API，拿到当前物种列表后，去匹配对应的插画素材，再把这些素材打包排版成一页，只在鸟种发生变化时才重新绘制。输出端支持两种形态：一是 Pimoroni 的 Inky Impression 电子墨水面板，二是一套服务同样画面的 Web Kiosk。素材方面，项目内置了超过 800 张剪裁图，覆盖 400 多个物种，全部取自真实的历史图版并经过人工筛选整理，没有一张是 AI 生成的（部分经过 AI 修图）。图片的许可证分风格目录管理，字体采用 SIL OFL 1.1，鸟类体重数据来自 AVONET 数据集。硬件推荐树莓派 5、Inky Impression 13.3 英寸（Spectra 6）、一个麦克风与 A4 相框，但墨水屏并非必需，没有屏幕时项目可纯网页运行。

快速上手

1. 准备硬件：树莓派 5、Inky Impression 电子墨水屏、麦克风与相框（也可仅用网页模式）。
2. 在树莓派上执行一键安装脚本，脚本会询问 BirdNET-Go 的部署位置与端口，克隆仓库、安装依赖并以 systemd 服务启动相框，全新系统下可能需要重启一次。
3. 也可以直接用 Docker 运行镜像，通过环境变量指定识别服务地址，Kiosk 在 8080 端口、管理页在同端口 /admin 路径。
4. 若要本地开发，先同步虚拟环境，启动一个模拟的识别服务与热重载的开发服务，即可在没有树莓派的机器上调试。

适用人群

适合喜欢鸟类与自然观察的爱好者、热衷于树莓派与电子墨水硬件改造的折腾党、以及欣赏复古博物学插画的用户。对居住在北欧、不列颠群岛与中欧地区的人来说，插画覆盖最好；其他地区目前支持有限，作者表示正在扩展欧洲与北美的物种覆盖。如果你只想买成品而不想动手，作者也接受定制咨询。

项目链接

https://github.com/arnegiacomo/fugleramme 线上实时画面：https://fugleramme.arnegiacomo.dev