Skip to main content

WeatherLink Live Local Python API

CI Documentation Status Coverage Status License: MIT PyPI PyPI - Python Version Ruff

Python library to read weather data from a Davis WeatherLink Live station + connected sensors (e.g. Vantage Vue). Features:

  • discover WeatherLink Live stations in the local network
  • read sensor values (called conditions) using the local API - no internet connection required

Although the WeatherLink Live stations are tighly coupled with the web service weatherlink.com, it can be used in offline situations aswell. The well designed HTTP interface makes it easy to read the current weather data via the local network - perfect for IoT / SmartHome applications. In fact, I couldn't find any other commercial weather station with an open ethernet-based protocol (please correct me if I'm wrong).

To set up the WeatherLink Live stations, you need the Davis WeatherLink app (Android, iOS) and a weatherlink.com account. Further sensors can be connected to the station. Afterwards, the weather data is accessible via weatherlink.com (if online) and the local API.

Documentation

Python library: https://weatherlink-live-local-python.rtfd.io/

API specification: https://weatherlink.github.io/weatherlink-live-local-api/

Install

pip install weatherlink-live-local

Example

import weatherlink_live_local as wlll

devices = wlll.discover()
print(devices)

# select first device, get IP address
ip_first_device = devices[0].ip_addresses[0]

# specify units
units = wlll.Units(
    temperature=wlll.TemperatureUnit.CELSIUS,
    pressure=wlll.PressureUnit.HECTOPASCAL,
    rain=wlll.RainUnit.MILLIMETER,
    wind_speed=wlll.WindSpeedUnit.METER_PER_SECOND,
)

# poll sensor data / conditions
while True:
    conditions = wlll.get_conditions(ip_first_device, units=units)
    print(f"Inside temperature:  {conditions.inside.temp:.2f} °C")
    print(f"Outside temperature: {conditions.integrated_sensor_suites[0].temp:.2f} °C")
    time.sleep(10)

Release files for weatherlink-live-local 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for weatherlink-live-local 0.4.0
File Size Uploaded
weatherlink_live_local-0.4.0.tar.gz 14.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for weatherlink-live-local 0.4.0
File Interpreter ABI Platform
weatherlink_live_local-0.4.0-py3-none-any.whl Python 3 none any Details

Total release size: 22.4 kB

Release history Release notifications | RSS feed

This release

0.4.0 This release

2 release files

0.3.0

2 release files

0.2.1

1 release file

0.2.0

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page