Twarner491
d3241f92cf
Blockers - http://birdnet.local/avian/ now serves the collage (added avian/index.html redirect to frontend/; previously the symlink target had no top-level index, so users saw a directory listing of api/ assets/ forwarding/ frontend/ scripts/). - Gemini model bumped from gemini-2.5-flash-image-preview (deprecated 2026-01-15) to the stable gemini-2.5-flash-image. Pregen was non- functional out of the box. - avian-mqtt.service: dropped %h (which expands to /root for system-mode units regardless of User=). Use WorkingDirectory=~ which DOES respect User=, plus a relative ExecStart. - birdnet-api.php case 'lifelist' now aliases COUNT(*) AS n (was 'total'), matching what apt.js reads for atlas card counts. Atlas previously always displayed 0. Bugs - Retry-After parsing handles HTTP-date format without crashing. - apt.js no longer fetches firstseen/timeseries (declared in state but never consumed). Two wasted round-trips per page load removed. - update_birdnet.sh defaults branch=avian-visitors so the (opt-in) Sunday auto-update cron doesn't reset HEAD to upstream main and delete the avian/ overlay. - recording.php: removed dead $BIRDS_JSON_CANDIDATES. Polish - Pregen --sleep default raised 4→6s (more headroom under free-tier RPM). - en-dash in README BOM (~$35–80) replaced with hyphen for style match. - Slop sweep across user-facing docs: no em-dashes, no en-dashes, no AI-slop word hits (robust/comprehensive/seamless/etc.).
67 lines
2.1 KiB
Markdown
67 lines
2.1 KiB
Markdown
# Forwarding
|
|
|
|
Default install hosts the collage at `http://birdnet.local/avian/` on your LAN, no auth. The recipes below are independent. Pick what you need.
|
|
|
|
---
|
|
|
|
## 1. Cloudflare Tunnel
|
|
|
|
Public HTTPS URL, no port forwarding. Needs a free Cloudflare account.
|
|
|
|
```bash
|
|
sudo apt install -y lsb-release
|
|
curl -fsSL https://pkg.cloudflare.com/cloudflare-main.gpg \
|
|
| sudo tee /usr/share/keyrings/cloudflare-main.gpg >/dev/null
|
|
echo "deb [signed-by=/usr/share/keyrings/cloudflare-main.gpg] https://pkg.cloudflare.com/cloudflared $(lsb_release -cs) main" \
|
|
| sudo tee /etc/apt/sources.list.d/cloudflared.list
|
|
sudo apt update && sudo apt install -y cloudflared
|
|
|
|
cloudflared tunnel login
|
|
cloudflared tunnel create birds
|
|
cloudflared tunnel route dns birds birds.your-domain.com
|
|
|
|
sudo cp ~/BirdNET-Pi/avian/forwarding/cloudflared.yml /etc/cloudflared/config.yml
|
|
# Edit /etc/cloudflared/config.yml: set `tunnel:` to your UUID
|
|
sudo cloudflared service install
|
|
sudo systemctl restart cloudflared
|
|
```
|
|
|
|
Add a password gate via Cloudflare Access (free for up to 50 users) or via Caddy basic_auth ([`caddy-auth.caddy`](caddy-auth.caddy)).
|
|
|
|
---
|
|
|
|
## 2. Home Assistant sensor
|
|
|
|
Add to `configuration.yaml`:
|
|
|
|
```yaml
|
|
rest:
|
|
- resource: http://birdnet.local/avian/api/birdnet-api.php?action=recent&hours=1
|
|
scan_interval: 60
|
|
sensor:
|
|
- name: "Latest Bird"
|
|
value_template: "{{ value_json.species[0].com if value_json.species else 'none' }}"
|
|
json_attributes_path: "$.species[0]"
|
|
json_attributes:
|
|
- sci
|
|
- n
|
|
- last_seen
|
|
- best_conf
|
|
```
|
|
|
|
---
|
|
|
|
## 3. MQTT bridge
|
|
|
|
```bash
|
|
sudo pip3 install paho-mqtt --break-system-packages
|
|
cp ~/BirdNET-Pi/avian/forwarding/mqtt-bridge.py ~/avian-mqtt.py
|
|
# Edit ~/avian-mqtt.py: broker host, topic prefix, credentials
|
|
sudo cp ~/BirdNET-Pi/avian/forwarding/avian-mqtt.service /etc/systemd/system/
|
|
# Edit /etc/systemd/system/avian-mqtt.service: set User= to your username
|
|
sudo systemctl daemon-reload
|
|
sudo systemctl enable --now avian-mqtt
|
|
```
|
|
|
|
Polls `birdnet-api.php?action=recent&hours=1` every 60 seconds. Publishes new species under `birdnet/<slug>` as JSON. Dedup is in-memory; restarts re-emit recent detections.
|