Poll Wunderground API or connect to Ambient Weather socket stream to receive current weather station information and publish it to a Websocket server, MQTT broker, and/or InfluxDB.
Your Wunderground API key is found under member settings.
Create an API key and Application Key under your Ambient Weather account
You will need to have either --wunderground or --ambient-weather as arguments, or it won't connect to either.
python main.py -h
usage: main.py [-h] [--wunderground] --api-key API_KEY --station-id STATION_ID
[--ambient-weather] [--application-key APPLICATION_KEY]
[--influx] [--influx-host INFLUX_HOST]
[--influx-port INFLUX_PORT] [--influx-db INFLUX_DB]
[--influx-measurement INFLUX_MEASUREMENT] [--websocket]
[--websocket-host WEBSOCKET_HOST]
[--websocket-port WEBSOCKET_PORT] [--mqtt]
[--mqtt-broker MQTT_BROKER] [--mqtt-prefix MQTT_PREFIX]
[--refresh-rate REFRESH_RATE] [--units UNITS] [--verbose]
[--stdout] [--raw-stdout]
Wunderground/Ambient Weather PWS Publisher
optional arguments:
-h, --help show this help message and exit
--wunderground enable wunderground api polling
--api-key API_KEY wunderground/ambient weather api key
--station-id STATION_ID
wunderground station id
--ambient-weather enable ambient weather api stream
--application-key APPLICATION_KEY
ambient weather application key
--influx publish to influxdb
--influx-host INFLUX_HOST
InfluxDB Host
--influx-port INFLUX_PORT
InfluxDB Port
--influx-db INFLUX_DB
InfluxDB Database
--influx-measurement INFLUX_MEASUREMENT
InfluxDB Name of Measurement for point
--websocket publish to WebSocket server
--websocket-host WEBSOCKET_HOST
WebSocket server host
--websocket-port WEBSOCKET_PORT
WebSocket server port
--mqtt publish to MQTT broker
--mqtt-broker MQTT_BROKER
MQTT broker
--mqtt-prefix MQTT_PREFIX
MQTT prefix for messages. ex: weather ->
weather/windSpeed
--refresh-rate REFRESH_RATE
time between Wunderground API requests
--units UNITS units for wunderground api to return. e=imperial.
m=metric. h=hybrid (uk)
--verbose Add debug messages
--stdout Write JSON to stdout of parsed data
--raw-stdout Write JSON to stdout of raw API data
- Edit
.env-sampleand copy/move to.env - Edit
docker-compose.ymlcommandline to enable/disable/edit any other arguments docker-compose pull(or build). Images are hosted on GHCR and are built for ARM and x86 on every master commit.docker-compose up -d
python3 -m venv venv
source venv/bin/activate
pip3 install -r requirements.txt
# wunderground example
python3 main.py --api-key 1234567890abcdef --station-id KTXHOUST3324 --wunderground --influx --websocket --mqtt
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent