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.
- ✅ 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+
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"| 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 |
-
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.)
- ⚙️ 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_attachis available in your ESPHome build.
MIT License — Free for personal and research use.