/ha-car_wash

Car Wash Binary Sensor for Home Assistant

Primary LanguagePythonOtherNOASSERTION

Please ⭐ this repo if you find it useful

Car Wash Binary Sensor for Home Assistant

GitHub Release GitHub Activity License Requires.io

hacs Project Maintenance

GitHub pull requests Bugs

Community Forum

This component checks the weather forecast for several days in advance and concludes whether it is worth washing the car now.

Example

Note:
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

HACS - Recommended

  1. Have HACS installed, this will allow you to easily manage and track updates.
  2. Search for "Car Wash sensor".
  3. Click Install below the found integration.
  4. Configure using the configuration instructions below.
  5. Restart Home-Assistant.

Manual

  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 car_wash.

  4. Download all the files from the custom_components/car_wash/ directory (folder) in this repository.

  5. Place the files you downloaded in the new directory (folder) you created.

  6. Add car_wash sensor to your configuration.yaml file:

    # Example configuration.yaml entry
    binary_sensor:
      - platform: car_wash
        weather: weather.gismeteo_daily
  7. Restart Home Assistant

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.

Note:
Unfortunately, the binary sensor can show only two states — “on” and “off”. In the case of this sensor, “on” should be interpreted as “it is worth washing the car”, and “off” — as “you should not wash the car”.

* * *

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

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

name:
(string) (Optional)
Name to use in the frontend.
Default value: 'Car Wash'

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

Usage examples

Follow the link to see example hou you can use this sensor in automations.

Track updates

You can automatically track new versions of this component and update it by custom-updater (deprecated) or HACS.

For custom-updater to initiate tracking add this lines to you configuration.yaml file:

# Example configuration.yaml entry
custom_updater:
  track:
    - components
  component_urls:
    - https://raw.githubusercontent.com/Limych/ha-car_wash/master/tracker.json

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][limych].

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

License

creative commons Attribution-NonCommercial-ShareAlike 4.0 International License

See separate license file for full text.