Skip to content

About

A fully self-contained ESPHome external component that connects directly to the Australian Bureau of Meteorology (BoM) to fetch current observations, forecasts, and weather warnings.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Latest commit

 

History

55 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

WeatherBOM – Bureau of Meteorology Weather for ESPHome (ESP-IDF)

A fully self-contained ESPHome external component that connects directly to the Australian Bureau of Meteorology (BoM) to fetch current observations, forecasts, and weather warnings — without Home Assistant or cloud dependencies.

Works entirely on-device using ESP-IDF networking and TLS, ideal for custom weather stations, dashboards, or offline displays.


✨ Features

  • ✅ No Home Assistant required — direct HTTPS access to BoM’s public API
  • ✅ ESP-IDF native (esp_http_client, esp_crt_bundle_attach)
  • ✅ Auto-resolves BoM geohash from:
    • Static latitude/longitude
    • Dynamic GPS sensors (latitude_sensor / longitude_sensor)
  • ✅ Publishes flattened sensors (no JSON parsing needed client-side)
  • ✅ Includes:
    • Current temperature, humidity, and wind speed
    • Today + tomorrow forecasts (min/max temps, rain chance, rain amount, summary, icon)
    • Active warnings (raw JSON string)
    • Location name & resolved geohash
    • Last update timestamp (ISO-8601)
  • ✅ Compatible with ESP32 / ESP32-S3 under ESPHome 2025.10+

⚙️ YAML Example

esphome:
  name: WeatherBom
  friendly_name: BOM Weather
  
esp32:
  board: esp32-s3-devkitc-1
  framework:
    type: esp-idf

external_components:
  - source: github://andrewbackway/esphome-weather_bom@main
    refresh: 1s

logger:
  level: DEBUG

api:

wifi:
  - ssid: !secret wifi_ssid
    password: !secret wifi_password

captive_portal:

web_server:
  version: 3

time:
  - platform: sntp
    id: sntp_time
    timezone: Melbourne/Australia
    servers:
      - 0.au.pool.ntp.org
      - 1.au.pool.ntp.org
      - 2.au.pool.ntp.org

sensor:
  - platform: template
    id: gps_lat
    name: "GPS Latitude"
    lambda: |-
      return -37.8136;
  - platform: template
    id: gps_lon
    name: "GPS Longitude"
    lambda: |-
      return 144.9631;

weather_bom:
  latitude_sensor: gps_lat
  longitude_sensor: gps_lon
  update_interval: 300s

  temperature:
    name: "Weather Temperature"
  humidity:
    name: "Weather Humidity"
  wind_speed_kmh:
    name: "Weather Wind Speed (km/h)"
  rain_since_9am:
    name: "Weather Rain Since 9AM"

  today_min:
    name: "Weather Today Min Temp"
  today_max:
    name: "Weather Today Max Temp"
  today_rain_chance:
    name: "Weather Today Rain Chance"
  today_summary:
    name: "Weather Today Summary"
  today_icon:
    name: "Weather Today Icon"
  today_rain_min:
    name: "Today's Rain Min"
  today_rain_max:
    name: "Today's Rain Max"
    
  tomorrow_min:
    name: "Weather Tomorrow Min Temp"
  tomorrow_max:
    name: "Weather Tomorrow Max Temp"
  tomorrow_rain_chance:
    name: "Weather Tomorrow Rain Chance"
  tomorrow_summary:
    name: "Weather Tomorrow Summary"
  tomorrow_icon:
    name: "Weather Tomorrow Icon"
  tomorrow_rain_min:
    name: "Tomorrow Rain Min"
  tomorrow_rain_max:
    name: "Tomorrow Rain Max"

  warnings_json:
    name: "Weather Warnings (JSON)"
  location_name:
    name: "Weather Location Name"
  out_geohash:
    name: "Weather Resolved Geohash"
  last_update:
    name: "Weather Last Update Time"

🧩 Published Entities

Category ID Type Description
Observations temperature, humidity, wind_speed_kmh Sensor Current BoM observations
Forecast (Today) today_min, today_max, today_rain_chance, today_rain_min, today_rain_max, today_summary, today_icon Sensor/Text Current day forecast
Forecast (Tomorrow) tomorrow_min, tomorrow_max, tomorrow_rain_chance, tomorrow_rain_min, tomorrow_rain_max , tomorrow_summary, tomorrow_icon Sensor/Text Next day forecast
Metadata warnings_json, location_name, out_geohash, last_update TextSensor JSON warnings, location info, update time

🌐 Data Sources

  • BoM Weather API (unofficial)
    https://api.weather.bom.gov.au/v1/locations/<geohash>/observations
    https://api.weather.bom.gov.au/v1/locations/<geohash>/forecasts/daily
    https://api.weather.bom.gov.au/v1/locations/<geohash>/warnings

  • Geohash Lookup
    https://api.weather.bom.gov.au/v1/locations?search=<lat>,<lon>

(All data remains property of the Bureau of Meteorology.)


⚠️ Notes & Limitations

  • ⚙️ Requires ESP-IDF framework (not Arduino).
  • 🌧️ API is unofficial — schema changes may occur; the component is defensive.
  • 🧠 Update interval default is 5 minutes (300 s).
  • 📶 Keep requests modest to avoid server throttling.
  • 🧩 All HTTPS handled using system CA bundle — ensure esp_crt_bundle_attach is available in your ESPHome build.

🧑‍💻 Author & License

MIT License — Free for personal and research use.

About

A fully self-contained ESPHome external component that connects directly to the Australian Bureau of Meteorology (BoM) to fetch current observations, forecasts, and weather warnings.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Contributors

Languages