Home

Awesome

Robert-Koch Institut COVID Numbers

⚠️⚠️⚠️

This repository has been archived.

Due to the lack of interest in current covid numbers and missing contributions, this component is no longer maintained. Feel free to get in contact if you wanna take over the maintenance.

</br></br></br>

GitHub contributors Version hacs_badge codecov

The rki_covid component is a Home Assistant custom sensor for monitoring regional covid numbers in Germany.

Table of contents

Installation

Install with HACS (recommended)

  1. Ensure that HACS is installed.
  2. Search for and install the "RKI Covid numbers" integration.
  3. Configure the rki_covid sensor.
  4. Restart Home Assistant.

Install manually

  1. Download the latest release.
  2. Unpack the release and copy the custom_components/rki_covid directory into the <config dir>/custom_components directory of your Home Assistant installation.
  3. Configure the rki_covid sensor.
  4. Restart Home Assistant.

Configuration

User interface

Open the Configuration of your Home-Assistant instance and select Integrations. Add a new integration, search and select rki covid. A dialog appears to select a district or state to monitor. After submitting the dialog, the newly added sensor entity is available.

Hint: Repeat the process to add multiple districts or states.

Configuration via User interface

Configuration.yaml

It is also possible to add districts / states via the configuration.yaml. Open your configuration file in an editor. Add a new sensor platform called rki_covid and add a list of districts by name.

sensor:
  - platform: rki_covid
    districts:
     - name: 'SK Augsburg'
     - name: 'SK Berlin Mitte'
     - name: 'BL Bayern'
     - name: 'LK München'

Hint: You have to validate the configuration (Configuration > Server Controls > Check configuration) and restart Home Assistant before the new sensors become available.

Entities

Each integration creates multiple entities in the format sensor.NAME_entity.

SensorTypeDescription
sensor.NAME_countnumberindicates the confirmed cases.
sensor.NAME_newCasesnumberindicates the new confirmed cases.
sensor.NAME_deathsnumberindicates the numbers of confirmed death cases.
sensor.NAME_newDeathsnumberindicates the numbers of new confirmed death cases.
sensor.NAME_recoverednumberindicates the numbers of confirmed recovery cases.
sensor.NAME_newRecoverednumberindicates the numbers of new confirmed recovery cases.
sensor.NAME_casesPer100knumberindicates cases per 100k.
sensor.NAME_weekIncidencenumberindicates the week incidence per 100.000 inhabitants.

Graph

Home-Assistant has built-in cards for graphs wich could be really helpful to display the current count with history.

type: sensor
graph: line
detail: 1
name: 'München '
entity: sensor.sk_munchen_weekincidence
hours_to_show: 72

lovelace_graph.png

Automations

For automations have a look on the trend platform.

Contribution

See Contribution for details.