Ha Gismeteo Save

Gismeteo Weather Provider for Home Assistant

Project README

Please :star: this repo if you find it useful

Gismeteo Weather Provider for Home Assistant

GitHub Release GitHub Activity License

hacs Project Maintenance Support me on Patreon

Community Forum

Component to integrate with Gismeteo weather provider.

This component can be used in two different ways: as a weather provider and as a set of sensors.

Gismeteo Logo

NB. You can find a real example of using this component in my Home Assistant configuration.

I also suggest you visit the support topic on the community forum.

Installation

  1. Have HACS installed, this will allow you to easily manage and track updates.
  2. Search for "Gismeteo Weather Provider".
  3. Click Install below the found integration.
  4. If you want to configure component via Home Assistant UI...
    in the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Gismeteo".
  5. If you want to configure component via configuration.yaml...
    follow instructions below, then restart Home Assistant.

Manual installation

  1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory (folder) there, you need to create it.
  3. In the custom_components directory (folder) create a new folder called gismeteo.
  4. Download file gismeteo.zip from the [latest release section][latest-release] in this repository.
  5. Extract all files from this archive you downloaded in the directory (folder) gismeteo you created.
  6. Restart Home Assistant
  7. If you want to configure component via Home Assistant UI...
    in the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Gismeteo".
  8. If you want to configure component via configuration.yaml...
    follow instructions below, then restart Home Assistant.

Breaking Changes

  • Since version 3.0.0...
    • the format of the component settings in file configuration.yaml has been changed. Now all the component settings are collected in a single block gismeteo.
    • forecast sensor is removed from component. Use forecast_days option instead.
  • Since version 2.2.0 forecast sensor has the name ... 3h Forecast instead of ... Forecast.

Configuration Examples

Adding the following to your configuration.yaml file will create two weather locations, one for the home coordinates and one for the remote location.

The first location will create one entity: just weather provider. The second location will create 21 sensors: four groups of sensors for current weather and forecasts for today and 2 days forward. Another 78 sensors will be created but disabled. You can enable that sensors through device settings.

# Example configuration.yaml entry
gismeteo:
  sweet_home:

  dacha:
    name: Our Country House
    latitude: ...
    longitude: ...
    add_sensors: yes
    forecast_days: 2

See below detailed descriptions to configure component.

* * *

I put a lot of work into making this repo and component available and updated to inspire and help others! I will be glad to receive thanks from you — it will give me new strength and add enthusiasm:


Patreon
or support via Bitcoin or Etherium:
Bitcoin
16yfCfz9dZ8y8yuSwBFVfiAa3CNYdMh7Ts

Configuration variables

gismeteo:
(map) (Required)
Map of your weather locations.

name:
(string) (Optional)
Name to use in the frontend.

latitude:
(float) (Optional) (Default: coordinates from the Home Assistant configuration)
Latitude coordinate to monitor weather of (required if longitude is specified).

longitude:
(float) (Optional) (Default: coordinates from the Home Assistant configuration)
Longitude coordinate to monitor weather of (required if latitude is specified).

add_sensors:
(boolean) (Optional) (Default: false)
Enable this option to add current weather and forecast sensors to the frontend.

forecast_days:
(positive int; 0–6) (Optional) (Default: do not create any sensors)
How many days ahead to make forecast sensors.
Note: Forecast sensors will be created only if add_sensors option is enabled.
Note: If you only need a forecast sensors for today, specify 0.

When sensors option are enabled, it creates 20 sensors. Each shows one aspect of current weather. Only few basic sensors are enabled by default. But you can enable any sensor through device settings.

When you add forecast_days option, integration creates additional 21 sensors for each day. Each shows one aspect of forecast weather for that day. As usual, only few basic sensors are enabled by default.

List of sensors that will be created:

condition
A human-readable text summary.

temperature
The air temperature.

apparent_temperature
The apparent air temperature.

low_temperature
The lowest air temperature per day.

humidity
The relative humidity of air.

pressure
The sea-level air pressure.

wind_speed
The wind speed.

wind_gusts_speed
The wind gusts speed.

wind_bearing
The wind bearing as an angle.

wind_bearing_2
The wind bearing as human-readable text.

cloud_coverage
Cloud coverage as a percentage.

precipitation
The precipitation amount volume.

rain_amount
The rain amount volume.

snow_amount
The snow amount volume.

storm
The storm prediction.

geomagnetic_field
The geomagnetic field value:
1 = No noticeable geomagnetic disturbance
2 = Small geomagnetic disturbances
3 = Weak geomagnetic storm
4 = Small geomagnetic storm
5 = Moderate geomagnetic storm
6 = Severe geomagnetic storm
7 = Hard geomagnetic storm
8 = Extreme geomagnetic storm

water_temperature
The temperature of water.

uv_index
The ultraviolet index:
0–2 = Low
3–5 = Moderate
6–7 = High
8–10 = Very high
11+ = Extreme

birch_pollen
Birch pollen concentration index:
1–10 = Low
11–50 = Moderate
51–500 = High
501+ = Very high

grass_pollen
Cereal grasses pollen concentration index:
1–10 = Low
11–50 = Moderate
51–500 = High
501+ = Very high

ragweed_pollen
Ragweed pollen concentration index:
1–10 = Low
11–50 = Moderate
51–500 = High
501+ = Very high

road_condition
Road surface condition as a human-readable text.

Track updates

You can automatically track new versions of this component and update it by HACS.

Troubleshooting

To enable debug logs use this configuration:

# Example configuration.yaml entry
logger:
  default: info
  logs:
    custom_components.gismeteo: debug

... then restart HA.

Contributions are welcome!

This is an active open-source project. We are always open to people who want to use the code or contribute to it.

We have set up a separate document containing our contribution guidelines.

Thank you for being involved! :heart_eyes:

Authors & contributors

The original setup of this component is by Andrey "Limych" Khrolenok.

For a full list of all authors and contributors, check the contributor's page.

License

creative commons Attribution-NonCommercial-ShareAlike 4.0 International License

See separate license file for full text.


Open Source Agenda is not affiliated with "Ha Gismeteo" Project. README Source: Limych/ha-gismeteo
Stars
110
Open Issues
0
Last Commit
2 weeks ago
Repository

Open Source Agenda Badge

Open Source Agenda Rating