From b33c020b7a8e64b2251cbc2ac23db88a9d8cdbe8 Mon Sep 17 00:00:00 2001 From: J-Lindvig <54498188+J-Lindvig@users.noreply.github.com> Date: Sun, 23 Jan 2022 20:50:34 +0100 Subject: [PATCH] Update README.md --- README.md | 53 ++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 52 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 435d9a4..20fe8f0 100644 --- a/README.md +++ b/README.md @@ -1 +1,52 @@ -# Flagdays_DK \ No newline at end of file +# Flagdays_DK + +[![hacs_badge](https://img.shields.io/badge/HACS-Custom-41BDF5.svg?style=for-the-badge)](https://github.com/hacs/integration) + +Sensor with official flagdays in Denmark, with a option to add your own (birthdays etc.) + +For installation instructions [see this guide](https://hacs.xyz/docs/faq/custom_repositories). +## Quick start +Add the following to your configuration.yaml +```yaml +flagdays_dk: + flags: + # Flags we own and want to use + - grønland + - færø + - pride + events: + # List of custom events + - name: Tim Berners Lee Birthday + date: '08-06-1955' + - name: Ada Lovelace Birthday + date: '10-12-1815' +``` +## State and attributes +State is the number of days to the event +![Screenshot](https://github.com/J-Lindvig/Flagdays_DK/blob/main/images/screenshot.png) +### Attributes +date_str: 5. februar +date: 5-2-2022 +flag_up_time: 08:42 +flag_down_time: 16:02 +timestamp: 1644046920 +days_to_event: 13 +event_name: Hendes Kongelige Højhed Kronprinsesse Marys fødselsdag +half_mast: false +half_mast_all_day: false +flag: Dannebrog + + +| Attribute name | Example value | Description | +|----------------------------|-------------------------------------------|------------------------------------| +| attribution | Created by J-Lindvig | Name of the creator | +| date_str | 5. februar | Nice TTS date of the event | +| date | 5-2-2022 | Date of the event | +| flag_up_time | 08:42 | Time to hoist the flag | +| flag_down_time | 16:02 | Time to pulle the flag | +| timestamp | 1644046920 | Timestamp of the event | +| days_to_event | 13 | Days to the event | +| event_name | Hendes Kongelige Højhed Kronprinsesse... | Name of the event | +| half_mast | false | Flag at half mast? | +| half_mast_all_day | false | Falg at half mast all day? | +| flag | Dannebrog | Name of flag to use |