Configuration Reference

Every setting that matters, organized by what it controls. The desktop app shows these in a tabbed ⚙ Settings dialog; the server shows them on a Blazor /settings page. The names and defaults are the same on both editions unless noted.

Desktop app settings

Open with ⚙ Settings. The dialog has twelve tabs; click Save to apply or Cancel to discard.

Camera (RTSP)

Bird Identification

Monitoring

Advanced

Other tabs (summary)

• Email Notifications, Pushover, NTFY & Windows — see Notification channels.
• Summary Reports — Daily / Weekly / Monthly digest schedules, recipients, and delivery method.
• Photo Frame — FTP or email-to-frame delivery of snapshots.
• Community — see Community sharing.
• Video Summary — intro card, music, highlight extraction, Ken Burns, scheduled daily summary time.
• Debug Logging — per-component log levels (None / Low / Medium / High) for Bird Identification, Camera, Motion, Monitoring loop, and MainForm/UI, plus log-file rotation.

Server settings

On the server edition, settings live on the Blazor /settings page. They're grouped into the same logical sections as the desktop app, but presented in one long scrollable page with anchored sub-sections rather than tabs. All settings persist to data/config.json in your mounted data folder.

Major sections

• Camera — RTSP URL (or Pi camera device path), Camera type dropdown, Test camera button, ONVIF toggle.
• Detection — Confidence threshold, motion detection threshold, cooldown, daily cap, daylight hours.
• Location & weather — ZIP code or lat/long, temperature unit.
• Notifications — Email (SMTP), ntfy push.
• Community — sharing toggle + Share Level.
• License — paste a license key; deactivate to move to another machine.
• Storage — snapshot retention policy, video retention, ForReview folder toggle.
• Backups & Migrate — see Part 8 → Backups & migration.

Notification channels

Email (SMTP) — both editions

1. Enable email notifications.
2. Set the SMTP server and port (Gmail: smtp.gmail.com / 587), keep SSL / TLS on.
3. Enter your sending email + password and one or more recipients (comma-separated).
4. Click Send Test Email.

ntfy push — both editions

ntfy is a free, open-source push service that needs no account.

1. Install the ntfy app on your phone.
2. In settings, enable ntfy, keep the server https://ntfy.sh, and choose a unique topic name (e.g. birdwatch-myfeeder-12345).
3. Subscribe to the same topic in the phone app.
4. Click Send Test Notification.

Pushover — desktop only

Pushover delivers instant push notifications (with the photo) to your phone, tablet, or desktop. Low-cost one-time purchase per platform after a free trial.

1. Create an account at pushover.net and install the app.
2. Create an application at pushover.net/apps/build.
3. In Settings → Pushover, enable it and paste your Application API Token and User Key.
4. Click 📱 Send Test Notification.

Windows desktop notifications — desktop only

Native Windows 10 / 11 toast pop-ups. Fast and local — no internet round-trip. Settings → NTFY & Windows tab.

Photo frame — desktop only

BirdWatchAI can push snapshots (and optionally videos) straight to a digital photo frame, turning it into a live bird gallery. In Settings → Photo Frame:

• Enable it, name the frame, choose whether to send snapshots, videos, and whether to auto-send on every detection.
• Pick a delivery method: FTP Upload (host, port, credentials, remote path, optional FTPS) or Email to Frame (the frame's email address + SMTP details).
• Click 🖼 Test Photo Frame.

You can also send any single detection on demand via the history right-click menu → 🖼 Send to Photo Frame.

Summary reports — both editions

Reports roll up your activity into a tidy digest with statistics, charts, and snapshots. Enable any of Daily / Weekly / Monthly with a chosen schedule, the recipient email(s), and the delivery method (Email / Pushover / Both on desktop; Email / ntfy on server). Reports are skipped automatically when there were no detections in the period.

Community sharing

Sharing is controlled in Settings → Community on both editions. The most important control is the Share Level, which precisely governs what leaves your machine:

Other options on the tab:

• Enable Community Sharing — the master switch.
• Automatically push each detection — uncheck to share only manually (right-click a detection → 🌐 Push to Community…).
• When you correct or delete a detection locally, the change syncs to the community automatically.
• Your install periodically sends a heartbeat so the website can show your feeder as online / monitoring.

Detection tuning — when defaults aren't right

The factory defaults work for most installs, but if you're getting too many false positives, missing real birds, or finding the AI keeps misidentifying things, here's what knob to turn:

On the desktop, the 📈 Telemetry window plots motion %, temperature, and your two thresholds against detection markers — the easiest way to pick a Motion Threshold that's just below real visits and above background sway.