/ha-snowtire

Home Assistant sensor to predict if it's time to change car tires from summer to winter and vice versa.

Primary LanguagePythonOtherNOASSERTION

Please ⭐ this repo if you find it useful

Snowtire Binary Sensor for Home Assistant

GitHub Release GitHub Activity License

hacs Project Maintenance Support me on Patreon

Community Forum

This component checks the weather forecast for several days in advance and concludes whether it is time to change car tires from summer to winter and vice versa.

Example

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

Breaking Changes

  • Since version 1.6.0:
    • The whole platform: snowtire entry under the binary_sensor: section in configuration.yaml is deprecated and should be replaced to snowtire: section or removed. Now you also can use the UI to change settings for the snowtire platform. Please adjust your configuration.yaml and restart Home Assistant.
    • Default name for sensor is your Home Assistant location name.

Installation

Install from HACS (recommended)

  1. Have HACS installed, this will allow you to easily manage and track updates.
  2. Search for "Snowtire".
  3. Click Install below the found integration.
  4. If you want to configure component via Home Assistant UI...
    in the HA UI add Snowtire sensor into system.
  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 snowtire.
  4. Download file snowtire.zip from the latest release section in this repository.
  5. Extract all files from this archive you downloaded in the directory (folder) you created.
  6. Restart Home Assistant
  7. If you want to configure component via Home Assistant UI...
    in the HA UI add Snowtire sensor into system.
  8. If you want to configure component via configuration.yaml...
    follow instructions below, then restart Home Assistant.

Configuration Example

# Example configuration.yaml entry (see variables description below)
snowtire:
  - weather: weather.<YOUR_WEATHER_PROVIDER_ENTITY_ID>

* * *

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

Note:
This sensor should work with any weather provider in any of it settings. But please note that the sensor cannot see further than the weather provider shows. Therefore, it is recommended to set the daily mode in the weather provider settings. If necessary, you can configure a separate weather provider instance especially for this sensor.

weather:
(string) (Required)
Weather provider entity ID.

unique_id
(string) (Optional)
An ID that uniquely identifies this sensor. Set this to a unique value to allow customization through the UI.

Note:
If you used the component version 1.3.0 or earlier, you can specify the special value __legacy__, so that no duplicates of already existing sensors are created.
The use of this special value in newly created sensors is not recommended.

Another way is to manually delete all old sensors via Configuration > Entities. Then restart HA and all the _2’s were was the original sensors again complete with their history.
My Entities

name:
(string) (Optional) (Default value: Your HA location name)
Name of area to use in the frontend.

days:
(positive integer) (Optional) (Default value: 7)
The number of days how far forward the sensor looks for the weather forecast.

create_notifications:
(boolean) (Optional) (Default value: True)
If True, component generates notifications to change tires.

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.snowtire: 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.

This Home Assistant custom component was created and is updated using the HA-Blueprint template. You can use this template to maintain your own Home Assistant custom components.

License

creative commons Attribution-NonCommercial-ShareAlike 4.0 International License

See separate license file for full text.