https://github.com/pilotak/homeassistant-clientraw
Clientraw weather parser (clientraw.txt) for HomeAssistant
https://github.com/pilotak/homeassistant-clientraw
clientraw davis hacs hass homeassistant weather
Last synced: 6 months ago
JSON representation
Clientraw weather parser (clientraw.txt) for HomeAssistant
- Host: GitHub
- URL: https://github.com/pilotak/homeassistant-clientraw
- Owner: pilotak
- License: apache-2.0
- Created: 2019-07-09T17:41:46.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2025-01-14T16:14:05.000Z (9 months ago)
- Last Synced: 2025-03-28T03:41:20.912Z (6 months ago)
- Topics: clientraw, davis, hacs, hass, homeassistant, weather
- Language: Python
- Homepage:
- Size: 56.6 KB
- Stars: 19
- Watchers: 1
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# HomeAssistant component: `clientraw`
[](https://github.com/pilotak/homeassistant-clientraw/actions)
[](https://github.com/custom-components/hacs)
The `clientraw` platform is WD Clientraw parser which can read data from your online weather station such a Davis Vantage PRO 2 (tested) and other generating clientraw.txt files
To add clientraw to your installation, add the following to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
sensor:
- platform: clientraw
url: "http://example.com/clientraw.txt"
monitored_conditions:
- temp
- humidity
```
Configuration variables:
- **url**: full path to clientraw.txt file
- **interval**: poll interval in minutes (1-59), 15 min is default
- **monitored_conditions** array: Conditions to display in the frontend.
- **dewpoint**: Dewpoint (°C or °F)
- **heat_index**: Heat index (°C or °F)
- **temp**: Temperature (°C or °F)
- **temp_indoor**: Temperature (°C or °F)
- **temp_day_max**: Today MAX temperature (°C or °F)
- **temp_day_min**: Today MIN temperature (°C or °F)
- **humidex**: Humidex (°C or °F)
- **wind_degrees**: Where the wind is coming from in degrees, with true north at 0° and progressing clockwise.
- **wind_dir**: Wind Direction as string ie.: N, NW, etc.
- **wind_gust_hour**: Wind Gust in last hour (km/h or mph)
- **wind_gust_day**: Wind Gust in last day (km/h or mph)
- **wind_speed**: Current Wind Speed (km/h or mph)
- **wind_speed_average**: Last 60 Sec Avg Wind Speed (km/h or mph)
- **wind_speed_avg_10min**: 10 Min Avg Wind Speed (km/h or mph)
- **symbol**: Symbol
- **daily_rain**: Daily Rain (mm or in)
- **yesterday_rain**: Yesterday Rain (mm or in)
- **monthly_rain**: Monthly Rain (mm or in)
- **yearly_rain**: Yearly Rain (mm or in)
- **rain_rate**: Rain rate (mm or in)
- **pressure**: Pressure (hPa or inHg)
- **humidity**: Relative humidity (%)
- **humidity_indoor**: Relative indoor humidity (%)
- **humidity_max**: Max relative humidity (%)
- **humidity_min**: Min relative humidity (%)
- **cloud_height**: Cloud Height (m or ft)
- **forecast**: string based output ie.: night showers
- **station**: station name with time added
- **date**: current date
- **wind_chill**: Wind Chill (°C or °F)
- **wind_chill_max**: Today MAX Wind Chill (°C or °F)
- **wind_chill_min**: Today MIN Wind Chill (°C or °F)
- **vp_solar**: Solar Irradiation (W/m² or BTU/(h×ft²))
- **uv_index**: UV Index
- **apparent_temp**: Apparent temperature (°C or °F)
- **apparent_temp_min**: Min apparent temperature (°C or °F)
- **apparent_temp_max**: Max apparent temperature (°C or °F)
## Install via [HACS](https://github.com/custom-components/hacs)
You can find this integration in a store.
## Install manually
You need to copy `clientraw` folder from this repo to the `custom_components` folder in the root of your configuration, file tree should look like this:
```
└── ...
└── configuration.yaml
└── custom_components
└── clientraw
└── __init__.py
└── manifest.json
└── sensor.py
```
>__Note__: if the `custom_components` directory does not exist, you need to create it.
## A full configuration example
```yaml
# Example configuration.yaml entry
sensor:
- platform: clientraw
url: "http://example.com/clientraw.txt"
interval: 10
monitored_conditions:
- dewpoint
- heat_index
- temp
- temp_indoor
- temp_day_max
- temp_day_min
- humidex
- wind_degrees
- wind_dir
- wind_gust_hour
- wind_gust_day
- wind_speed
- wind_speed_avg_10min
- symbol
- rain_rate
- daily_rain
- yesterday_rain
- monthly_rain
- yearly_rain
- pressure
- humidity
- humidity_indoor
- cloud_height
- forecast
- station
- date
```
Symbol codes:
```
0 = sunny
1 = clear night
2 = cloudy
3 = cloudy2
4 = night cloudy
5 = dry
6 = fog
7 = haze
8 = heavyrain
9 = mainly fine
10 = mist
11 = night fog
12 = night heavy rain
13 = night overcast
14 = night rain
15 = night showers
16 = night snow
17 = night thunder
18 = overcast
19 = partly cloudy
20 = rain
21 = rain2
22 = showers
23 = sleet
24 = sleet showers
25 = snow
26 = snow melt
27 = snow showers2
28 = sunny
29 = thunder showers
30 = thunder showers2
31 = thunder storms
32 = tornado
33 = windy
34 = stopped raining
35 = windy rain
36 = sunrise
37 = sunset
```