Skip to content

Latest commit

 

History

History
254 lines (196 loc) · 9.39 KB

README.md

File metadata and controls

254 lines (196 loc) · 9.39 KB
Raw

Please ⭐ 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 for any given coordinates and as a set of sensors for current coordinates of a house.

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

Note: If you configure the integration through the Home Assistant GUI, the weather provider and sensors will be created at the same time. But you're limited to only one set of settings. When configuring via configuration.yaml file, you can create multiple weather providers.

Install from HACS (recommended)

  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 2.2.0 forecast sensor has the name ... 3h Forecast instead of ... Forecast.

Configuration variables

Weather Provider Configuration

The gismeteo weather platform uses Gismeteo as a source for current meteorological data for a specified location.

Example

To add Gismeteo weather provider to your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
weather:
  - platform: gismeteo

You can add as many providers with different configurations as you wish.

* * *

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

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

mode:
(string) (Optional)
Can specify hourly or daily. Select hourly for a three-hour forecast for 24h, daily for daily forecast for a week.
Default value: hourly

latitude:
(float) (Optional)
Latitude of the location to display the weather.
Default value: The latitude in your configuration.yaml file.

longitude:
(float) (Optional)
Longitude of the location to display the weather.
Default value: The longitude in your configuration.yaml file.

Weather Sensors Configuration

The gismeteo sensors uses Gismeteo as a source for current meteorological data for your home location. The forecast will show you the condition in 3 h.

Example

To add Gismeteo sensors to your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  - platform: gismeteo
    monitored_conditions:
      - weather

You can add only one group of sensors.

* * *

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

name:
(string) (Optional)
Additional name for the sensors. Default to platform name.
Default value: Gismeteo

forecast:
(boolean) (Optional)
Enables the forecast for 3h. The default is to display only the current conditions.
Default value: false

monitored_conditions:
(list) (Required)
Conditions to display in the frontend.

condition
A human-readable text summary.

temperature
The current temperature of air.

temperature_feels_like
The current feeling of temperature of air.

humidity
The relative humidity of air.

pressure
The sea-level air pressure in millibars. At the same time, a second sensor is created, indicating the same pressure in mmHg.

wind_speed
The wind speed.

wind_bearing
The wind bearing.

clouds
Description about cloud coverage.

rain
The rain volume.

snow
The snow volume.

storm
The storm prediction.

geomagnetic
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 current temperature of water.

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! 😍

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.