Roadmap

What's been released and what's coming next.

Released

v0.13 — Mobile & On-Device

Mobile always-on background mode: foreground service, wake lock, WiFi lock, AlarmManager keepalive
Custom native RecordingService with persistent notification (bird icon, recording stats, pause state)
Battery optimization exemption prompt on startup
Fresh MQTT connection on foreground return (handles Android WebSocket suspension)
Remote satellite log retrieval via MQTT (hub requests, satellite responds with logs)
Get Logs button on satellite detail page (Pi: journalctl, mobile: in-app logs)
Mobile app OTA updates: self-hosted APK distribution via hub API
In-app update banner with download prompt (version check on startup)
Platform admin: upload APK, manage releases, force update toggle
Build script auto-upload with API key auth
Nginx 200MB upload limit for APK files
Detections overview: species grouped by count with time range tabs (today/week/month/year), server-side sorting
Species profile revamp: hero image + stats layout, full paginated detection list with filters/sort
First-of-day/season changed from per-satellite to per-tenant
Remote satellite log retrieval via MQTT (Get Logs button)
ConfidenceRing shared component (used on detections overview and analytics)
Lightbox click no longer triggers parent navigation

v0.18 — Unified model registry UI + precision dashboard

Catalog and Installed lists merged into one unified, single list per kind with two-line rows. State badge per row (Actif · Installé · Installé désactivé · Disponible · Disponible masqué); quantization badge (FP32/FP16/INT8) auto-derived from name. Sort: active first, then enabled installed, then disabled, then available, then hidden
Active models are no longer deletable — the user must promote another first. Lifecycle hint at the top of each section: "install from catalog (or upload your own) → set as active"
13 catalog entries: BirdNET v2.4 / v2.3 / v2.2 / v2.1 each in FP32 / FP16 / INT8, plus Perch v2 (embedding). All from stable URLs (raw.githubusercontent.com pinned commits + HuggingFace mirror). All flagged with their license (BirdNET CC-BY-NC-SA, Perch Apache 2.0)
Catalog dismiss: × hides an entry, ↺ restores. Stored as a platform_settings.dismissed_catalog_ids array. "Voir les écartés" toggle to view hidden entries. Per-platform, not per-user
Builtin BirdNET row removed from the registry — it was confusing noise. Migration 050 deletes source = 'builtin' rows and auto-promotes the most recent custom classifier as the new default. Worker still has the bundled birdnetlib model loaded as a silent fallback when no active classifier is configured
New birdnet_models.kind column ('classifier' / 'embedding'); the previous kind column was renamed to source ('builtin' / 'custom'). Default is per-kind so a classifier and an embedding model can both be active simultaneously
Per-model precision dashboard on the Compare Models page: each model shows total detections, verified count, confirmed, rejected, and precision % (= confirmed / verified). Drill-down shows per-species precision sorted by sample size; species with <10 verified detections get a small-sample warning. Recall intentionally not measured — no ground truth for misses. Shadow models excluded since humans verify only the main feed
Catalog accepts ?kind=classifier|embedding and ?showHidden=true query parameters. New POST /api/models/catalog/dismiss endpoint to toggle dismiss state
New GET /api/models/precision-stats endpoint returns per-model summary + per-species breakdown grouped by model_id, computed from detections.verification_status over a configurable window (1–365 days)

v0.17.1 — Embedding model registry + capacity counting

Embedding models are now first-class entries in the birdnet_models registry alongside classifiers. New kind column ('classifier' | 'embedding'); the previous kind column was renamed to source ('builtin' | 'custom')
Per-kind default — a BirdNET classifier and a Perch embedding model can both be is_default=TRUE simultaneously
Perch v2 is installable from the catalog UI (one-click; downloads from HuggingFace, stores in MinIO). Storage bar's existing "Models" segment now counts both classifiers and embedding models
Bootstrap: existing host-mounted storage/perch/perch_v2.tflite files get auto-uploaded to MinIO and registered on the next worker startup. After bootstrap, the host file can be deleted
Worker embedding loader queries the registry per-job (60 s cache), downloads the active embedding model from MinIO into a local cache. Switching models is one click in the UI
Migration 049: rename kind → source, add new kind column with default 'classifier', replace single-default index with per-kind index

v0.17 — Acoustic embeddings + cosine-weighted trust score

Per-chunk Perch v2 audio embeddings (Google bird-vocalization-classifier, 1536-dim float16, Apache 2.0). Worker uses TFLite runtime — no full TensorFlow needed; image stays at ~1.28 GB
Embeddings only computed for chunks that produced detections (silent chunks skipped). Storage: ~3 KB/chunk; ~30 MB/day per tenant at typical detection rates
Trust-score behavior: neighbor support is now Σ confidence × cos(target_emb, neighbor_emb) instead of Σ confidence. Coincidental same-label hits with dissimilar embeddings get less weight; real co-calling clusters get more. Falls back to weight=1.0 when either embedding is NULL (existing behavior preserved)
Optional install: drop perch_v2.tflite into storage/perch/. Without it, embeddings are skipped and the trust score works exactly as before
Migration 048: audio_chunks.embedding bytea + partial index, embedding_enabled and embedding_model platform settings
Justin Chuby's HuggingFace mirror (justinchuby/Perch-onnx) provides the CPU-friendly TFLite build

v0.16.1 — Multi-image gallery + storage breakdown

Multi-image species gallery via Wikimedia Commons (up to 6 images per species, configurable in platform settings); thumbnail strip + lightbox with arrow / swipe / keyboard nav, attribution overlay, link to source
Background backfill: existing cached species get extras over time; rate-limited to respect Wikimedia
Storage cap bar now displays four segments (audio protected / unprotected / images / models) with a hover-tooltip breakdown, plus soft + hard markers
BirdNET model bytes counted toward the cap (read live from MinIO), image cache extras included
Multi-image dedup via SHA-256 hash + URL filtering (drops duplicates and non-photo files: range maps, recordings, signatures)
Cleaner APK delete: Modal confirmation, MinIO removal verified via statObject, audit log entry
Removed dead code: ~700 lines of unused side-panel SatelliteDetail from Satellites.tsx (replaced by the dedicated SatelliteDetailPage last release)
Migrations 046 (species_image_files) and 047 (cleanup of duplicate extras from initial rollout)

v0.16 — Multi-Model BirdNET + Period Picker

Multi-model BirdNET registry: birdnet_models table, per-detection model_id foreign key, bundled birdnetlib model marked default at install
Catalog of historical models installable from the BirdNET-Analyzer GitHub repo with one click (v2.4 / v2.3 / v2.2 / v2.1)
Custom model upload (TFLite + labels) stored in MinIO; inference worker resolves the active default within ~60 s of an admin change
Inference compare mode (A/B): worker runs every enabled non-default model on a configurable sample of chunks, writing to a separate shadow_detections table so user-facing stats stay clean
Model Compare admin page: per-model summary, agreement vs default (compared / agree / default-only / shadow-only / agreement rate), top species the shadow models found that the default missed
Hard capacity cap for audio retention: third pass that purges keep-best/pinned chunks (oldest first) when usage exceeds the hard cap; bar shows soft + hard markers
Custom calendar picker for day/week/month/year period navigation across Compare and Timeline; respects the user's "start of week" preference end-to-end (calendar grid, period boundary, hub query)
Compare page (location comparison) accepts period=day|week|month|year + offset instead of just rolling days
Platform Settings: styled checkboxes + file inputs globally; Models card with active-model banner and styled file picker
Migrations 042 (birdnet_models + detections.model_id), 043 (label bundled model with version), 044 (audio_storage_hard_cap_gb), 045 (inference_mode + shadow_detections)

Unified alerts pipeline: AlertRulesEngine is the sole dispatcher; system rules auto-seeded per tenant (rare_species, first_of_day, first_of_season, satellite_offline) are editable but not deletable
Webhooks merged into alert_channels as a channel type; existing webhooks auto-migrated and auto-attached to the system rules matching their event_types
Three fire modes on rules: cooldown (time-based), once_until_clear (requires acknowledgement), on_state_change (auto-resets when condition clears — used by satellite_offline: alert fires only on transition offline, suppressed while still offline, ready to fire again when the satellite comes back and goes offline next)
Cooldown scope: global / per_species / per_satellite — replaces the old coarse global cooldown
Message template on rules + payload template on every channel type (email HTML, Slack Block Kit JSON, Telegram HTML, Google Chat cardsV2 JSON, Discord embed JSON, webhook free-form)
Per-channel-type format toggles: include_image, include_link, use_blocks, use_card, image_in_header, use_embed, embed_color, use_html
"Load default as starting point" button: dumps the hub's built-in template reflecting the current toggle state into the textarea
Shared variable namespace across rule + channel templates (27 placeholders: rule/species/satellite/tenant/links to wikipedia/ebird/xeno-canto, etc.)
Inbox tab in the Alerts page with unread filter, type filter, mark-all-read
Sidebar "Alerts" link gains an unread-count badge
Dashboard banner narrowed to warning/critical severity (info-level system alerts live in the inbox)
eBird-based rarity: species not on the eBird "recently observed near here" list flagged as is_rare with reason "unexpected in this region"
Species Timeline: period navigation (prev / now / next) shifts by day/week/month/year, human-readable period label, Now reset button
Timeline satellite filter + per-bucket RMS silence detection (bucket painted dark purple when no chunks arrived OR mean RMS below threshold) — surfaces "satellite was running but mic was off" gaps
Backfill script for audio_chunks.rms (historical data)

v0.14 — Data Management

Adjacent clip stitching: consecutive same-species detections merged into single detection with concatenated audio (6s window, max 30s, on-the-fly WAV concatenation)
Duration badge on stitched detections, stitched audio playback via SpectrogramPlayer
Audio retention: platform-admin-configurable two-pass purge (capacity cap then time window) to keep MinIO usage bounded
Keep-best: top-N detections per species by confidence preserved regardless of age (cap may be exceeded)
User-pinned detections immune to retention (📍 toggle on every detection card)
Stitched groups preserved as a unit when any member is keep-best
Detection rows retained forever; only audio blobs purged (audio endpoints return 410 Gone for purged clips)
Platform Settings UI: live storage usage bar (protected vs purgeable split), cap/days/keep-best inputs, "Run sweep now", last-run summary
Per-detection call-segment highlights on spectrograms: pink freq × time rectangles per syllable
Two-stage call-detection pipeline: BirdNET oracle (9s extended audio, 2.5s overlap) localizes the species' coarse region, librosa silence-splitting subdivides into syllables, coverage validation drops non-target syllables, per-species empirical frequency bands filter cross-species noise, per-segment peak/median ratio finds each call's true frequency band
Empirical species-frequency-bands table refreshed every 12h from trusted detections
Trust score: logit-space blend of raw BirdNET confidence with neighbor support (same species within ±60s); surfaces weak lone detections
Trust badge and filter ("Confirmed only") + sort-by-trust on detection cards
Species Timeline view: one heatmap row per species showing when it's active; period selector (today/week/month/year), sort (recent/count/dawn chorus/A-Z), pink "now" marker, configurable bucket granularity (15 min → 1 day)
Backfill CLI for call_segments (--hours, --species, --force)

v0.12 — Satellite Detail & Alerts

Dedicated per-satellite page with full-width sections (activity, schedule, filters, config, biodiversity, expected species, live audio)
Stats cards row (status, recording, version, location, CPU, storage, uptime, last seen)
Today's hourly activity bar chart on satellite detail page
Schedule 24h bar visualization with sun times for all profiles (right-aligned)
Editable satellite config with override editor (lock, customize, reset)
Expected species: centered pills with links to species profile (detected only)
Alert rules: inline rename, duplicate (disabled by default)
Alert channels: inline rename
Species profile: share and comment buttons on detection list
Chart improvements: pixel-based bar heights, date labels, locale-aware formatting
Weather correlation: detection bar overlay (from bottom), fixed date format bug
Dashboard: taller trend and activity charts with detection counts
i18n: satellite status/recording/version translation keys
Alert rules: "once per species per day" condition, detection date/time in all channels
Alert deduplication: watcher_processed flag prevents re-evaluation of detections
Alert messages: removed redundant detection summary (structured fields only)
Satellite outbox: auto-recreate corrupted SQLite database on startup
Live audio overhaul: hub-signaled unfiltered streaming via MQTT (live-start/stop/keepalive)
Live audio: inline base64 via WebSocket, continuous auto-play with chunk chaining
Force update button: always visible on satellite detail (bypasses version check)
Satellite: WAV file cleanup on ack, periodic purge of outbox DB entries
Satellite: git SHA in startup log and update script output
Mosquitto ACLs for live-start, live-stop, live-audio, update-status topics
Mobile app: live audio support (subscribe live-start/stop, publish unfiltered chunks)
Mobile app: BuildKit Gradle cache for faster APK builds
Expected species scoped to satellite (not global)
Activity charts: hide future hours on today's view
Satellite names: ellipsis truncation on detection lists
Weather chart: fixed detection date offset (timezone)
Live audio: gapless LiveSpectrogramPlayer with AudioContext streaming, auto-boost compressor, 15s buffer
Live audio: hidden when satellite not recording, buffering indicator
Migration chart: primary language only, compact rows, show all species toggle
Top species: confidence ring chart (avg + max) replacing two columns
Satellite immediate heartbeat on state change (recording/error/paused)

v0.11 — Satellite Polish & Live Audio

Pi satellite audio device autodetection (when AUDIO_DEVICE is not set)
Satellite heartbeat reports "error" state after consecutive capture failures with auto-recovery
Remote update via MQTT with status feedback and detached script execution
Git authentication for remote updates (HTTPS token or SSH key via .env)
Version and audio device logged on satellite startup
Chunk filter stats: aggregate tracking (processed/sent/rejected by reason) in heartbeat
Filter stats display in satellite detail panel with pass rate bar
Per-session filter pass rate on timeline ("X% sent" pill)
Live audio streaming: "Listen live" on satellite detail with SpectrogramPlayer
Field notes API and migration (text, photos, weather, location — backend ready)
First-of-day/first-of-season duplicate alert fix (atomic conditional UPDATE)
SpectrogramPlayer: auto-boost (peak normalization), buffering indicator, spectrogram alignment fix
Species profile: sort detections by confidence or date
Shared detection page: today's count, static OG page for link previews (Discord, Slack, Telegram, etc.)
Open Graph link previews for bot-detected platforms (Discord, Slack, Telegram, WhatsApp, Twitter, Facebook)
Reliable remote satellite update via systemd-run transient unit
Update script: timestamps, retries, error trapping, PATH fix for detached execution
Comprehensive release protocol documentation

v0.10 — Internationalization (i18n)

English and French translations (500+ keys, every page)
Language switcher, locale-aware formatting, translated map popups and heatmap labels
Singular/plural support via Intl.PluralRules
Alert messages in tenant's language (species names, labels, rarity reasons)
First-of-day detection alerts with badge on detection cards
Start-of-week day preference for heatmaps
Species images not-found investigation panel with per-species retry
Public share URLs in alert notifications with species image
Notification images via Wikipedia direct URLs
Shared detection page: translated species names, stats, lightbox, user language preferences
Open Graph link previews (Discord, Slack, Telegram, WhatsApp, Twitter, Facebook)
SpectrogramPlayer audio preloading with buffering indicator
French translation quality pass (gender-neutral phrasing, idiomatic terms)
Timeline session auto-splitting at 600 chunks
Abbreviated relative times on detection pills
Species search across all 38 languages, sort by primary language