Raspberry Pi 用 E-Ink バードフレーム：Fugleramme

窓ガラスは少し汚れています——リスたちが餌を盗んでいるためです。

注意： 現在は早期開発段階です。稀なバグや未実装の機能がある可能性がありますが、今後多数の新機能を追加していく予定です。

北欧（ノルウェー・ベルゲン）の庭でリアルタイムに動作しており、厨房の窓からアクセスできます：

fugleramme.arnegiacomo.dev

ハードウェア構成、インストール手順、運用ドキュメントはこちら。

仕組みについて

• BirdNET-Go：マイク入力を監視し、音声分類を担当します。
• Fugleramme：BirdNET-Go の API をポーリングし、検出された鳥種に対応するイラストをマッチングさせます。
  • 検出が変わらない間は描画しない（省電力）。
  • 種類が変化するとのみ再描画を行います。
• 表示媒体：
  • 推奨：Inky Impression（E-Ink パネル）
  • Web キオスク形式での動作も可能。
• カスタマイズ：管理者ページ（

  /admin

  ）から表示内容や自動更新設定を変更できます。

ヒント： E-Ink パネルは必須ではありませんが、体験感を損なわないために推奨されます。使用しない場合は、HDMI 接続またはネットワーク経由での Web ブラウザ表示になります。

ハードウェア構成

• Raspberry Pi 5
• Inky Impression 13.3"（Spectra 6 モデル）
• マイク
• A4 サイズのフレーム

パーツリスト、推奨製品、および代替品については「Hardware」ページをご確認ください。

アートワークについて

このプロジェクトは、素晴らしいパブリックドメインの自然史イラストを披露することを目的としています。

• コレクション：
  • 800 点以上のハログラフ（切り抜画）を収録。
  • 400 種以上の鳥類を表しています。
  • 実際の銅版画から手作業で厳選・調整されています（AI 生成アートの使用はありませんが、補正は一部利用）。
• 表示方法：
  • 検出された鳥のイラストを背景除去し、テクスチャ入り紙面上に配置します。
  • 大きな鳥は中央寄りに配置され、体型に応じてサイズが調整されます。
  • 何も検出されない場合は空の perch（つる）が表示されます。
• 対応地域：
  • ノルディック諸国、イギリス諸島、ドイツに由来する版画を採用しており、これらの地域での使用が最適です。
  • より広範なヨーロッパおよび北米への対応も進行中です。

手切り処理の詳細手順については「Adding artwork」をご覧ください。

事例紹介

• 検出なし
• 数名の来訪者
• 庭園全体が賑わう様子

インスピレーションと関連プロジェクト

デザインは、壁に掲げているアクセル・トーレンフェルトによる WWF Verdens naturfond ポスターをヒントにしています。

着想の源： 「AvianVisitors」で見かけたリアルタイム・フレームのアイデアと、BirdNET-Go の検出機能を活用しました。

類似プロジェクト

以下のプロジェクトとはコードやアートワークは共有していません。

ローカル環境での実行（開発用途向け）

バイヤー仮想環境のセットアップと開発サーバー起動方法：

# バイヤー仮想環境のセットアップ
uv sync

# ポート 8090 で BirdNET-Go の代替品（フェイク検出器）を起動
uv run fugleramme-fake-detector

# ホットリロード機能を備えた開発モードとしてポート 8080 で起動
uv run fugleramme-dev

フェイク・デテクターのフラグ設定や、実際の観測ステーションへの動作検証については「Pi 以外での実行」をご参照ください。

Raspberry Pi へのインストール

Raspberry Pi の上でハードウェアが稼働していることを前提としています。

# リポジトリクローン、依存関係インストール、systemd サービス起動のすべてを行う
curl -fsSL https://raw.githubusercontent.com/arnegiacomo/fugleramme/main/install.sh | bash

注意： 新規システムの場合は再起動が必要になる可能性が高いです。空の SD カードからのインストールについては「完全なインストールガイド」をご覧ください。

コンテナ環境での実行

Docker を使用する場合：

docker run -d \
    -p 8080:8080 \
    -v fugleramme:/data \
    -e FUGLERAMME_DETECTOR_URL=http://birdnet.local:8080 \
    ghcr.io/arnegiacomo/fugleramme

リポジトリからイメージを構築する場合

# イメージの構築
docker build -t fugleramme .

# コンテナの起動
docker run --rm \
    -p 8080:8080 \
    -v fugleramme:/data \
    -e FUGLERAMME_DETECTOR_URL=http://birdnet.local:8080 \
    fugleramme

• キオスク表示：ポート

  8080

• 管理画面：

  /admin

• データ保持先：

  /data

  ディレクトリ

Linux マシンでの USB マイク使用例

BirdNET-Go も同時に起動できる設定です。

curl -fsSL https://raw.githubusercontent.com/arnegiacomo/fugleramme/main/examples/docker-compose.yml -o docker-compose.yml
docker compose up -d

コンテナに関する詳細については「Container」ページをご覧ください。

コントリビュート（貢献）

不具合報告、バグ修正、ドキュメント改訂、アートの提供などのご貢献を大歓迎し、積極的に奨励しております。

• 不具合報告：
  • まず FAQ をご覧いただき、引き続き「Discussions」にてご報告ください。
• 質問・アイデア、または自作フレーム：
  • まず FAQ を確認の上、「Discussions」にてご相談ください。
• 修正提案、ドキュメント更新、切り抜いた鳥のデータ：
  • プルリクエスト（PR）を提出してください。問題報告は不要です。

詳細については「Contributing」ページをご覧ください。

ライセンス

LICENSE

詳細な出典情報については、各アセットフォルダ内の

ATTRIBUTION.md

既製フレーム

いくつかの自作フレームがございます。ご自身で作成されることなく、既製のフレームをご希望の場合はご連絡ください。