Self-host Inky Bird Frame
v0.9.8Bird sightings become reviewed field-journal plates
- Stars
- 202
- Port
- 8793 (controller HTTP server for browser journal, catalog, and display node API)
ghcr.io/veteranbv/inky-bird-frame
What is Inky Bird Frame?
Inky Bird Frame helps birders keep birding present between outings by turning nearby observations, personal eBird history, acoustic detections, and smart-feeder postcards into reviewed, reusable field-journal plates. The system has two roles: a controller that discovers birds, generates plates using AI (Codex), and runs independent factual and visual reviews; and a lightweight display node that pulls approved plates and rotates them on a color e-paper frame. The controller also serves a browser-based journal at /app for managing favorites, trip collections, and source connections. It runs on Docker (AMD64/ARM64 images from GitHub Container Registry) or natively on macOS, Ubuntu, or Raspberry Pi OS with Python 3.11+. All observation history and credentials stay private on the controller; approved plates are location-neutral and reusable across installations. Integrations include iNaturalist, eBird (public and archive), BirdWeather, self-hosted BirdNET-Go, BirdNET Analyzer CSV imports, and Bird Buddy. Optional notifications via Apprise (Pushover, Discord, ntfy, Gotify, Slack, email, Home Assistant). Home Assistant and Homepage dashboard cards are supported. Authentication uses local username/password with optional HTTPS and Authentik OIDC. The project is pre-1.0 (development candidate) with MIT license.
Should you self-host Inky Bird Frame?
Inky Bird Frame scores 46/100 on selfhost.directory (how scoring works) and ranks #14 of 19 in Photo Galleries. It has 202 GitHub stars.
It shipped 10 stable releases in the past year. The latest, v0.9.8, came out on 22 October 2026. New versions land roughly every 2 days.
Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is MIT-licensed and written mostly in Python.
Its closest alternative on selfhost.directory is Immich (93/100, 117 490 stars). It scores higher overall, so compare the two before you pick. See Inky Bird Frame vs Immich side by side.
Features
- AI generation with independent review
- Authentik OIDC authentication
- Browser journal
- Docker and native installation
- E-paper display node
- Field-journal plates
- Home Assistant Integration
- Homepage dashboard cards
- Multi-source bird discovery
- Notifications
- Private by design
- Public plate catalog
Inky Bird Frame README
More in Photo Galleries
MemtlySelf-hosted, open-source event photo gallery where guests upload and view photos/videos via QR codes, with admin moderation and multiple database backends.
ownphotosA self-hosted, open-source take on Google Photos built on a Django backend and React frontend, with face recognition, object search, event albums and a map view.
pellicolaPellicola is a self-hosted PHP photo publishing app with EXIF, maps, albums, RSS, and GDPR compliance.
PhotoPrismAI-Powered Photos App 🌈💎✨
PhotoShowPhotoShow is a self-hosted, open-source PHP web gallery for organizing photos with drag-and-drop upload, themes, responsive design, and no database required.
PicImpactOpen-source, self-hosted photo portfolio site with a masonry gallery, Live Photos, WebGL viewer, EXIF and map views, RSS, S3/R2/AList storage, TOTP and passkeys.
Pic-OSelf-hosted photo publishing platform (Laravel 12) with albums, tokenized share links, masonry grid viewer, slideshow, and Docker deployment.
picpeakSelf-hosted photo gallery for photographers to share password-protected, expiring galleries with clients. Includes proofing, guest uploads, and white-label branding.
PicsurPicsur is a self-hosted, open-source image sharing service in the spirit of Imgur, with format conversion, image editing, expiring uploads and a ShareX endpoint.
piksiA self-hosted PHP media gallery that displays photos, videos, and audio from folder structures with a simple UI designed for non-technical users and family sharing.
PixelFedA self-hosted, open-source photo and video social network that federates over ActivityPub with albums, stories, direct messages and chronological feeds.
shaarkShaark is a self-hosted, open-source platform for web links, markdown posts, passwords, and photos with tagging, search, RSS, dark mode, and PWA.
0 comments