CasaOS is an open-source personal cloud system with a home-focused web UI for running Docker apps and managing files on your own hardware.
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
Install on a Raspberry Pi with the install script
Install with the official instructions in the README - 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
A self-hostable personal dashboard for homelabs with service status checks, widgets, themes, icon packs and a UI config editor.
Open source digital signage platform that turns Raspberry Pi and PC displays into managed content screens.
A Streamlit web UI built on yt-dlp that downloads single videos or playlists and files them into folders that Plex, Jellyfin or Emby can scan.
Lightweight self-hosted server monitoring with a web dashboard, Docker container stats, historical data and alerts.
Self-hosted real-time monitoring dashboard for Proxmox, Docker, Kubernetes, TrueNAS and vSphere, with alerts and scheduled AI patrols.