Repolode
arnegiacomo

arnegiacomo/fugleramme

A picture frame that shows the birds detected by a BirdNET-Go microphone, drawn as hand-cut 1800s bird illustrations on e-ink or any screen.

Stars
3,805
Forks
135
Open issues
22
Last commit
9 hours ago

What is it?

Fugleramme is a bird frame for a Raspberry Pi or a homelab. It polls a BirdNET-Go instance, which listens on a microphone and identifies birds by sound, then matches each detected species to an illustration and arranges them on a page. The page is redrawn only when the set of birds changes, so an e-ink panel refreshes rarely.

The artwork consists of nearly 1200 cut-outs covering over 650 species, taken from public-domain natural-history plates. The frame can run on an Inky Impression e-ink panel, but also in a container on a NAS or laptop, with the page adapting to a TV, HDMI display, browser, or desktop wallpaper. An admin page controls what is shown, and all data persists in a local volume. Detection runs fully locally.

BirdNET-Go is installed separately and carries its own non-commercial license, which applies to the detection component.

Key features

  • 01Shows birds detected in real time by BirdNET-Go audio identification.
  • 02Renders nearly 1200 hand-cut illustrations covering over 650 species.
  • 03Redraws only when the detected birds change, suiting e-ink panels.
  • 04Runs on a Raspberry Pi with an Inky Impression or in a Docker container.
  • 05Adapts the page to e-ink, TV, HDMI, browser or desktop wallpaper.
  • 06Offers species names in 40+ languages and an admin page for configuration.

Use cases

  • Displaying garden birds heard by a microphone on a windowsill e-ink frame.
  • Running a bird display on a homelab, NAS or old laptop with a TV or browser.
  • Showing a live bird collage on a Samsung-style TV or HDMI screen in a home or office.

Quick start

  1. 1

    Install on a Raspberry Pi with the install script

    Install with the official instructions in the README
  2. 2

    Or run the container, pointing it at your BirdNET-Go instance

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

Things to know

  • Detection requires BirdNET-Go, installed separately, and it is licensed CC BY-NC-SA 4.0 for non-commercial use only.
  • Built around a Raspberry Pi and an Inky e-ink panel; hardware parts are needed for the full frame experience.

Topics

FAQ

What is fugleramme?
A picture frame that shows the birds detected by a BirdNET-Go microphone, drawn as hand-cut 1800s bird illustrations on e-ink or any screen. Fugleramme is a bird frame for a Raspberry Pi or a homelab. It polls a BirdNET-Go instance, which listens on a microphone and identifies birds by sound, then matches each detected species to an illustration and arranges them on a page. The page is redrawn only when the set of birds changes, so an e-ink panel refreshes rarely.
Is fugleramme free to use? What license does it have?
fugleramme is open source under the MIT license. Check the license terms before using it in commercial products.
Is fugleramme still maintained?
Actively maintained. The last commit to fugleramme was on Oct 20, 2026.
What can I use fugleramme for?
Displaying garden birds heard by a microphone on a windowsill e-ink frame. Running a bird display on a homelab, NAS or old laptop with a TV or browser. Showing a live bird collage on a Samsung-style TV or HDMI screen in a home or office.
How do I install fugleramme?
Install on a Raspberry Pi with the install script Or run the container, pointing it at your BirdNET-Go instance: docker run -d -p 8080:8080 -v fugleramme:/data -e FUGLERAMME_DETECTOR_URL=http://birdnet.local:8080 ghcr.io/arnegiacomo/fugleramme
Where can I get fugleramme?
The source code and installation instructions are on GitHub: https://github.com/arnegiacomo/fugleramme

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects