Skip to content

Latest commit

 

History

History
79 lines (62 loc) · 3.66 KB

README.md

File metadata and controls

79 lines (62 loc) · 3.66 KB
Raw

hacs_badge

Neerslag App

Neerslag app for Home Assistant. All-in-one package (Sensors + Card).

Display rain forecast using Buienalarm and/or Buienradar sensor data. The Neerslag App (and the sensors) is fully configurable via the Home Assistant interface.

This package contains the Neerslag Card. Make sure to uninstall the Neerslag Card package from Home Assistant before using the Neerslag App to avoid unexpected behaviour. This includes manually removing the custom sensors.

Features

  • Everything from the Neerslag Card;
  • Built-in Buienalarm and Buienradar sensors;
  • Ability to configure this app via the GUI;
  • Can use build-in Home Assistant configured location.

Example

Installation overview

  1. Install via HACS or manual;
  2. Configure the Neerslag App (via interface);
  3. Add the Neerslag Card to your dashboard.

1a. Install via HACS (recommended)

This is the recommended option and also allows for easy updates.

  1. Find this repository in HACS and click install
  2. Restart Home Assistant and clear the browser cache;
  3. Add the Neerslag App as an Integration in Home Assistant (menu: settings -> devices & services -> add integration);
  4. Restart Home Assistant and clear the browser cache (optional).

For updates go to the Community Store (HACS) and click update.

1b. Manual install

Not recommended, you will need to track updates manually by browsing to the repository;

  1. Download the latest release of the Neerslag App from this repository;
  2. In Home Assistant, create a folder config/custom_components;
  3. Add the Neerslag App to the custom_components folder;
  4. Restart Home Assistant;
  5. Add the Neerslag App as an Integration in Home Assistant (menu: settings -> devices & services -> add integration);
  6. Restart Home Assistant and clear the browser cache (optional).

For updates, repeat step 1 to 4. Home Assistant will not delete any configuration.

2. Configure the Neerslag App (via interface)

The Neerslag App is fully configurable via the interface.

  1. Go to (menu: settings -> devices & services -> add integration) and click on configure.
  2. Select which sensor you want to use and provide the location data. There is an option to use the built-in Home Assistant location data. If this checkbox is selected, it will override the location settings of the individual sensors.

3. Add the Neerslag Card to your Dashboard

  1. Go to your dashboard, go to configure UI;
  2. Click add card;
  3. Find the Neerslag Card in the list of cards;
  4. Add the card and configure the card.

Note: Due to caching, The Neerslag Card might not be visible in the Home Assistant card selector directly after installing the Neerslag App. Restart Home Assistant and clear the browser cache to resolve this.

Using one sensor:

type: 'custom:neerslag-card'
title: Neerslag
entity: sensor.neerslag_buienalarm_regen_data

Using two sensors:

type: 'custom:neerslag-card'
title: Neerslag
entities:
  - sensor.neerslag_buienalarm_regen_data
  - sensor.neerslag_buienradar_regen_data

Note: If Home Assistant has not yet received data from the sensors, the card can remain blank.

Advanced configuration options:

Enable auto zoom to have the graph dynamically zoom in or out depending on the amount of rainfall.

Note: By default auto zoom is disabled. Which gives the graph a fixed starting position displaying low, medium and heavy rainfall. Auto zoom will continue on extreme rainfall. Before version 2022.07.07.1 this setting was set to true.

autozoom: false