Eine Kamera am Vogelhaus, ein Rechner der erkennt wer da war — und eine Sammlung, die sich von allein fuellt. Zwei neuronale Netze: eines findet den Vogel im Bild, eines bestimmt die Art. 148 heimische Arten, auf Deutschland eingeschraenkt und neu normiert — ohne diese Einschraenkung wird aus einer Kohlmeise eine nordamerikanische Schwesterart. Daraus entsteht ein Sammelalbum: nummerierte Seiten, gefundene Arten in Farbe, fehlende als Schatten, dazu Erstfang, Punkte, Stufen und 15 Abzeichen. Laeuft vollstaendig auf eigener Hardware. Kein Cloud-Dienst, kein Konto, keine Telemetrie; die Bilder verlassen das eigene Netz nicht. Zwei getrennt deploybare Teile: die Sammlung als Django-Anwendung, die Erkennung als eigener Dienst. Der Erkennungs-Dienst fragt selbst an und braucht deshalb weder eine erreichbare Adresse noch einen offenen Port — er laeuft hinter einem gewoehnlichen Router. Dabei: Firmware fuer Raspberry Pi und ESP32-S3, Anbindung an Home Assistant ueber MQTT, Oberflaeche auf Deutsch und Englisch, Einstellungen je Kamera aus dem Browser, und ein Weg fuer Fotos von unterwegs. AGPL-3.0.
71 lines
2.3 KiB
Desktop File
71 lines
2.3 KiB
Desktop File
# Ein Detector je Kamera. Der Name hinter dem @ waehlt die Umgebungsdatei:
|
|
#
|
|
# systemctl enable --now vogelalbum-detector@futterhaus
|
|
# -> liest /etc/vogelalbum-futterhaus.env
|
|
#
|
|
# Genau so vorgeschlagen im Kopf von vogelalbum-detector.service, umgesetzt am
|
|
# 24.09.2026 beim Aufsetzen von LXC 112.
|
|
#
|
|
# Zugangsdaten je Kamera in /etc/vogelalbum-<name>.env (chmod 600, root:root):
|
|
# VOGELALBUM_SOURCE=http://vogelkamera.local:8080/stream
|
|
# VOGELALBUM_API=http://sammlung.local:8000
|
|
# VOGELALBUM_TOKEN=<Token aus dem Backend>
|
|
# VOGELALBUM_SAVE_TO=/var/lib/vogelalbum/<name>/rohdaten
|
|
# VOGELALBUM_LIVE_PORT=8131
|
|
# VOGELALBUM_KLASSIFIZIERE=2
|
|
#
|
|
# 🔑 Ein Dienst je Kamera und nicht einer fuer beide: Der Detector liest
|
|
# genau einen Bildstrom. Abwechselnd zu lesen hiesse, die Aufmerksamkeit je
|
|
# Kamera zu halbieren -- und an der Traenke ist ein Vogel womoeglich kuerzer
|
|
# da als am Futterhaus.
|
|
|
|
[Unit]
|
|
Description=Vogelalbum-Detector fuer Kamera %i
|
|
After=network-online.target
|
|
Wants=network-online.target
|
|
|
|
[Service]
|
|
Type=simple
|
|
User=vogelalbum
|
|
Group=vogelalbum
|
|
WorkingDirectory=/opt/vogelalbum
|
|
EnvironmentFile=/etc/vogelalbum-%i.env
|
|
Environment=PYTHONUNBUFFERED=1
|
|
|
|
# Die Schwellwerte stehen bewusst hier und nicht im Code: sie gehören zur
|
|
# Kamera, nicht zum Programm. 'gate detector' ignoriert Bewegung — nötig,
|
|
# weil unsere Kamera auf eine Hecke schaut, die im Wind steht.
|
|
# --nachtsicht ergaenzen, wenn die Kamera Infrarot hat. Ohne den Schalter
|
|
# pausiert die Analyse, sobald das Bild zu dunkel zum Erkennen ist.
|
|
ExecStart=/opt/vogelalbum/venv/bin/python -m detector watch \
|
|
--gate detector \
|
|
--classify-every ${VOGELALBUM_KLASSIFIZIERE} \
|
|
--cooldown 5 \
|
|
--min-bird-frames 1 \
|
|
--verbose
|
|
|
|
# Der Stream reißt nachts gern mal ab; einfach wieder hochkommen.
|
|
Restart=always
|
|
RestartSec=15
|
|
|
|
# ⚠ Die Kameras lassen nur EINEN Zuschauer zu. Beim Neustart muss der alte
|
|
# Prozess seine Verbindung erst loslassen, sonst bekommt der neue nichts.
|
|
KillSignal=SIGTERM
|
|
TimeoutStopSec=20
|
|
|
|
# Ein Bilderkenner braucht weder Schreibzugriff aufs System noch neue Rechte.
|
|
NoNewPrivileges=true
|
|
PrivateTmp=true
|
|
ProtectSystem=strict
|
|
ProtectHome=true
|
|
ProtectKernelTunables=true
|
|
ProtectControlGroups=true
|
|
RestrictSUIDSGID=true
|
|
ReadWritePaths=/var/lib/vogelalbum
|
|
|
|
StandardOutput=journal
|
|
StandardError=journal
|
|
|
|
[Install]
|
|
WantedBy=multi-user.target
|