Home Assistant custom integration for Birdfy smart bird feeder cameras. Browse and play SD card recordings directly from the HA Media Browser, and download thumbnails or videos to local or network storage.
- Media Browser: browse recordings by day and play clips directly in HA
- Sensor: last detection event with timestamp and attributes
- Camera: thumbnail of the last detection
- Download thumbnails: save event thumbnails to local or network storage (delta mode)
- Download videos: save event videos as MP4 to local or network storage (delta mode)
- Polls the Netvue cloud API every 5 minutes
- Multi-device support
- No local hardware required
- In Home Assistant, go to HACS → Integrations
- Click the three-dot menu → Custom repositories
- Add
https://github.com/sebsst/birdfy-integrationwith category Integration - Install Birdfy Integration
- Restart Home Assistant
- Go to Settings → Devices & Services → Add Integration → search for Birdfy
- Enter your Netvue/Birdfy account email and password
| Entity | Description |
|---|---|
sensor.birdfy_last_event |
Label and attributes of the last detection |
camera.birdfy_thumbnail |
Thumbnail image of the last detection |
| Attribute | Description |
|---|---|
label |
Detection label (e.g. bird, unknown) |
alert_time |
Timestamp of the detection |
alarm_id |
Unique event identifier |
image_url |
Direct URL of the event thumbnail |
Open the Media Browser in the HA sidebar → Birdfy → select a day → play a clip.
Clips are streamed as MP4 via ffmpeg (HLS → MP4 transcoding). ffmpeg must be available on the Home Assistant host (included by default in HA OS).
Downloads event thumbnails (JPG) to local or network storage. Only downloads files that don't already exist (delta mode). Defaults to today only.
| Parameter | Description | Default |
|---|---|---|
days |
Number of days to fetch (1–30) | 1 |
share |
Network share name mounted in HA under /media/ (takes priority over path) |
— |
path |
Full path where thumbnails will be saved | /media/birdfy_thumbnails |
Example automation:
action:
- service: birdfy.download_thumbnails
data:
days: 1
share: my_nasWith multiple cameras, a subfolder per device serial number is created automatically under the base path.
Downloads event videos (MP4) to local or network storage. Only downloads files that don't already exist (delta mode). Requires ffmpeg on the HA host. Defaults to today only.
| Parameter | Description | Default |
|---|---|---|
days |
Number of days to fetch (1–30) | 1 |
share |
Network share name mounted in HA under /media/ (takes priority over path) |
— |
path |
Full path where videos will be saved | /media/birdfy_videos |
Example automation:
action:
- service: birdfy.download_videos
data:
days: 1
share: my_nasTo use a NAS or network share:
- In Home Assistant, go to Settings → System → Storage
- Add your network share (SMB or NFS)
- The share will be mounted under
/media/<share_name> - Use
share: <share_name>in the service call
- The
labelfield is alwaysunknownif your camera model does not return AI classification - SD card recordings are stored as HLS streams on Netvue S3 servers, valid for approximately 1 hour after fetch
- Video download requires ffmpeg (available by default on HA OS)
- For live RTSP streaming, see birdfy-rtsp