BlackHalo logo
Published on

树莓派+电子墨水屏:实时听鸟声并绘制19世纪风格插图的开源项目

Authors
  • Name
    arnemunthekaas
    github.com
电子墨水屏上显示的19世纪风格鸟类插图,背景为纹理纸,中央有较大鸟类,边缘有空白栖枝。
头图来源: Picsum

项目简介

Fugleramme 是一个结合了树莓派、电子墨水屏和本地 AI 的创意开源项目。它通过麦克风实时捕捉环境中的鸟鸣,利用 BirdNET-Go 模型进行本地识别,然后将检测到的鸟类物种匹配到19世纪风格的公共领域插图上,最终在电子墨水屏上呈现出一幅复古风格的“鸟类快照”。项目作者来自挪威卑尔根,目前已在自家厨房窗外部署,实时显示花园中出现的鸟类。

工作原理

音频检测与识别

  • 项目使用 BirdNET-Go 作为音频分类器,该模型由康奈尔鸟类学实验室和开姆尼茨工业大学开发,完全本地运行,无需联网。
  • 麦克风持续监听环境声音,BirdNET-Go 实时分析音频片段,识别出鸟类的物种。
  • Fugleramme 轮询 BirdNET-Go 的 API,获取当前检测到的鸟类列表。

插图匹配与排版

  • 项目内置了超过800张手工裁剪的鸟类插图,覆盖400多个物种,全部来自19世纪的公共领域自然历史图鉴。
  • 每张插图都经过背景去除处理,并按照物种名称与检测结果匹配。
  • 排版算法将较大的鸟类放在页面中央,按体重比例缩放,背景为纹理纸效果。
  • 如果没有检测到鸟类,则显示一根空栖枝。

显示与更新

  • 默认使用 Inky Impression 13.3 英寸电子墨水屏(Spectra 6 色彩),功耗极低,仅在鸟类变化时刷新画面。
  • 同时提供 Web 界面(kiosk 模式),可通过浏览器访问同一视图,方便在没有电子墨水屏的情况下使用。
  • 管理员页面允许配置显示内容、更新频率等。

硬件组成

  • 树莓派 5(推荐,但也可用其他型号)
  • Inky Impression 13.3 英寸电子墨水屏(Pimoroni 出品)
  • USB 麦克风
  • A4 相框(用于安装屏幕)
  • 项目提供了完整的硬件清单和替代方案。

艺术来源与版权

  • 所有插图均来自19世纪欧洲(斯堪的纳维亚、英国、中欧)的公共领域自然历史图鉴,手工裁剪并整理。
  • 没有使用 AI 生成的图像,但部分插图经过 AI 辅助修整。
  • 插图按风格文件夹存放,每个文件夹附带归属说明(如 classic 风格采用 CC BY-SA 4.0 许可)。
  • 字体使用 SIL OFL 1.1 许可的开源字体。
  • 鸟类体重数据来自 AVONET 数据库(CC BY 4.0)。

安装与运行

快速安装(树莓派)

  • 在树莓派上运行一键安装脚本:curl -fsSL https://raw.githubusercontent.com/arnegiacomo/fugleramme/main/install.sh | bash
  • 脚本会询问 BirdNET-Go 的安装位置和端口,克隆仓库,安装依赖,并创建 systemd 服务。

Docker 运行

  • 提供 Docker 镜像,可快速部署:docker run -d -p 8080:8080 -v fugleramme:/data -e FUGLERAMME_DETECTOR_URL=http://birdnet.local:8080 ghcr.io/arnegiacomo/fugleramme
  • 也可使用 docker-compose 同时启动 BirdNET-Go 和 Fugleramme。

开发模式

  • 使用 uv sync 创建虚拟环境,uv run fugleramme-fake-detector 启动模拟检测器,uv run fugleramme-dev 启动开发服务器(带热重载)。

贡献与许可

  • 项目欢迎贡献,尤其是修复 bug、文档改进和新增插图。
  • 代码采用 MIT 许可。
  • BirdNET 模型采用 CC BY-NC-SA 4.0(非商业用途)。
  • 插图按各自文件夹的许可条款使用。

类似项目与灵感

  • 灵感来自 WWF 的鸟类海报和 Instagram 上的 AvianVisitors 项目。
  • 类似项目包括 AvianVisitors(AI 生成插图)、inky-bird-frame(野外日志风格)、HABirdDashboard(Home Assistant 卡片)等。
  • Fugleramme 不共享代码或艺术资源。

总结

Fugleramme 是一个将现代 AI 音频识别、复古艺术和低功耗电子墨水屏巧妙结合的开源项目。它不仅展示了技术可能性,也为观鸟爱好者提供了一种优雅的实时观察方式。项目仍在早期开发阶段,但已具备完整功能链,适合喜欢动手的爱好者尝试。

原标题:Show HN: An e-ink frame that hears birds and draws them as 1800s illustrations。 HN 原始发布时间:2026年9月15日星期二。当前记录为 1359 分、183 条评论。

阅读原文 · 查看 HN 讨论