@@ -193,6 +193,35 @@ plugins:
       layer_control: false
 ```
 
+### Bird sightings near home
+
+<img src="docs/images/birds.png" alt="Places where birds were seen around Tampere, with a popup listing three species and their pictures" width="400">
+
+A feed from [Birds Nearby](https://github.com/jesmak/birds_nearby). Each place is one point, its badge the number of
+species, and a place with a notable sighting is drawn in orange. Tapping a species' picture shows it large.
+
+```yaml
+type: custom:map-card
+title: Birds nearby (10 km)
+x: 61.498
+y: 23.761
+zoom: 11
+plugins:
+  - name: Birds
+    hacs:
+      module: ha-map-card-plugin-map-feed
+      file: ha-map-card-plugin-map-feed.js
+    options:
+      entity: sensor.birds_nearby_sighting_places
+      show_area: true
+      area_color: white
+      layer_control: false
+```
+
+The sightings in the picture are made up. The species pictures are from Wikimedia Commons: Bohemian Waxwing by
+Tatiana Bulyonkova (CC BY-SA 2.0), Fieldfare by Bengt Nyman (CC BY 2.0) and Eurasian Bullfinch by Francis Franklin
+(CC BY-SA 3.0).
+
 ### Tips
 
 - `map_options: {zoomControl: false}` hides ha-map-card's zoom buttons; pinch and scroll zoom still work.