|
1 | | -# atomic calendar card v0.7.5 |
| 1 | +# atomic calendar card v0.8.1 |
2 | 2 | Advanced calendar card for Home Assistant with Lovelace |
| 3 | +Work in progress. If you have any problems, please use v0.7.5 |
3 | 4 |
|
4 | 5 | Calendar card with advanced settings. It loads calendar events from Home Assistant - Google calendar component. |
5 | 6 |
|
@@ -94,6 +95,13 @@ If you have any suggestions about design or functionality, please let me know, o |
94 | 95 | | showProgressBar | boolean | optional | v0.5.5 | `true` Show event progress with moving icon. Don't enable when showCurrentEventLine - will look bad |
95 | 96 | | progressBarColor | string | v0.5.5 | `default color` Color of progress bar |
96 | 97 |
|
| 98 | +### Entity options (configurations for each calendar) |
| 99 | +| Name | Type | Since | Description | |
| 100 | +|------|:----:|:-----:|-------------| |
| 101 | +| type | string | optional | v0.5.5 | `null` Type of calendar (in calendar mode) Icon1, Icon2, Icon3, Birthday. Explained below. |
| 102 | +| blacklist | string | v0.7.9 | `null` List of comma separated blacklisted keywords. Events containing any of them will not be shown. |
| 103 | + |
| 104 | + |
97 | 105 | ## 3. Calendar Mode |
98 | 106 | The second mode of view - calendar mode - is to show full month calendar with simple events icons or colors, for most important, infrequent events, like holiday or birthday. |
99 | 107 | You can change mode by clicking "Calendar" title, or even make it default view. |
@@ -150,6 +158,7 @@ Simple configuration: |
150 | 158 | - entity: calendar.kalendarz_dom |
151 | 159 | color: red |
152 | 160 | - calendar.atomic7777 |
| 161 | + blacklist: 'word1, word2' |
153 | 162 | |
154 | 163 | ``` |
155 | 164 |
|
@@ -202,39 +211,22 @@ Simple configuration, both Events mode and Calendar mode, calendar is default: |
202 | 211 | ``` |
203 | 212 |
|
204 | 213 | ## 6. How to show more than 5 events |
205 | | - |
206 | | -This card will show maximum 5 events from each calendar. It's because of Home Assistant component limit. If you want to show more events, you have to download the google calendar component: |
207 | | - |
208 | | -1. Go to your Home Assistant config directory (where you have configuration.yaml file) |
209 | | -2. Create a subdirectory `custom_components/google` and go inside: |
210 | | -3. Download files. Important: in Home Assistant 89.0 and above all 3 files are needed! It will be ignored if you have only calendar.py.  |
211 | | - |
212 | | - |
213 | | - |
214 | | - |
| 214 | +You have to add `max_tesults` setting to `google_calendars.yaml` file: |
215 | 215 | ``` |
216 | | -mkdir -p custom_components/calendar |
217 | | -cd custom_components/calendar |
218 | | -wget https://raw.githubusercontent.com/home-assistant/home-assistant/master/homeassistant/components/google/calendar.py |
219 | | -wget https://raw.githubusercontent.com/home-assistant/home-assistant/master/homeassistant/components/google/__init__.py |
220 | | -wget https://raw.githubusercontent.com/home-assistant/home-assistant/master/homeassistant/components/google/tts.py |
| 216 | +- cal_id: xxxxxxxxxxxxxxxxxxxx@group.calendar.google.com |
| 217 | + entities: |
| 218 | + - device_id: calendar_id |
| 219 | + name: Calendar_name |
| 220 | + max_results: 15 |
221 | 221 | ``` |
222 | | -4. Open the Google.py file with text editor and change ``'maxResults': 5,`` to anything you want. |
223 | | -5. Save the file and restart Home Assistant. |
224 | 222 |
|
225 | 223 | ## 7. Automatic update |
226 | | -Automatic update using `custom_updater` component: |
227 | | -1. You need custom_updater installed and configured |
228 | | -2. Download atomic-calendar.js to `/www/atomic-calendar.js` as any other card |
229 | | -3. Add this reference to ui-lovelace.yaml (just change `/local` to `/customcards`): |
230 | | -``` |
231 | | - resources: |
232 | | - - url: /customcards/atomic-calendar.js |
233 | | - type: module |
234 | | -``` |
235 | | -4. Add this url line to `custom_updater` settings in `configuration.yaml`: |
| 224 | +Automatic update using `HACS` component: |
| 225 | +1. You need HACS installed and configured |
| 226 | +2. Go to Community tab, Settings |
| 227 | +3. Paste this line into `Add custom repository` field: |
236 | 228 | ``` |
237 | | -custom_updater: |
238 | | - card_urls: |
239 | | - - https://raw.githubusercontent.com/atomic7777/atomic_calendar/master/tracker.json |
| 229 | +https://github.com/atomic7777/atomic_calendar |
240 | 230 | ``` |
| 231 | +4. Choose type: Plugin |
| 232 | +5. The atomic_calendar component will be installed and updated. |
0 commit comments