ioBroker iCal adapter

This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers. For more details and for information how to disable the error reporting see Sentry-Plugin Documentation! Sentry reporting is used starting with js-controller 3.0.

This adapter allows to read .ics files from specific URL and parse it (Google Calendar or iCal). Alternatively it is possible to use a local .ics file (use absolute path to the file instead of URL)

Read english here.

Siehe deutsche Version hier.

This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers. For more details and for information how to disable the error reporting see Sentry-Plugin Documentation! Sentry reporting is used starting with js-controller 3.0.

Todo

• data.trigger doesn't support check option
• fix timezone stuff in tests

Changelog

1.9.2 (2021-03-07)

• (Apollon77) Prevent crash case when summary is not provided (Sentry IOBROKER-ICAL-K)

1.9.1 (2021-01-30)

• (Apollon77) try to make sure all code is executed before adapter is ended

1.9.0 (2021-01-12)

• (christofkac) Added option to ignore case when events are searched in calendars
• (Apollon77) Prevent crash case (Sentry IOBROKER-ICAL-F)

1.8.5 (2021-01-01)

• (Apollon77) update ical library to prevent problems with RRULE parsing

1.8.4 (2020-12-27)

• (Apollon77) Prevent crash case (Sentry IOBROKER-ICAL-D)

1.8.3 (2020-12-24)

• (Apollon77) Prevent crash case (Sentry IOBROKER-ICAL-C)
• (Apollon77) Upgrade node-ical

1.8.2 (2020-11-29)

• (klein0r) Several fixes and optimizations

1.8.1 (2020-11-20)

• (klein0r) Fixed past event calculation in html view

1.8.0 (2020-11-14)

• (klein0r) Moved html options to separate tab
• (klein0r) Added option to hide "arrow" on for running events
• (klein0r) Added feature to include past events (in days)

1.7.5 (2020-11-08)

• (Apollon77) Only handle events with a start date (Sentry IOBROKER-ICAL-1, IOBROKER-ICAL-2, IOBROKER-ICAL-4)
• (JensMaus) Update dependencies, fix some more issues

1.7.4 (2020-08-26)

• (Apollon77) Fix multiple parsing

1.7.3 (2020-08-26)

• (foxriver76) we pin a specific dependency version, because "rrule" package broken
• (foxriver76) added eslint

1.7.2 (2019-12-02)

• (bluefox) Documentation was changed

1.7.1 (2019-01-08)

• (twonky4) Fixed issue with UTC of until in recurring appointments
• (twonky4) Fixed possible empty color

1.7.0 (2018-11-27)

• (twonky4) Add filter option
• (twonky4) Add support of events for configured date period; changed state names from events.* to events.0.today.*
• (twonky4) Add Count of events for tomorrow - state data.countTomorrow
• (twonky4) Events without time part and same start and end are interpreted as full day events
• (twonky4) Remove special chars from event states

1.6.6 (2018-10-22)

• (twonky4) Fixed html for disabled colorize
• (twonky4) Fixed timezone handling for events during change from daylight saving time back to standard time
• (twonky4) Fixed events without end date moved to different day

1.6.5 (2018-10-13)

• (twonky4) Simplify timezone solution
• (twonky4) Fix calendars without timezones

1.6.4 (2018-10-12)

• (twonky4) Support windows timezones
• (twonky4) Don't fail on invalid timezones

1.6.3 (2018-10-10)

• (twonky4) Fixes timezone issue in fullday recurring appointments

1.6.2 (2018-10-08)

• (twonky4) Fixes timezone issue in recurring appointments

1.6.1 (2018-06-04)

• (Apollon77) Several fixes and optimizations

1.6.0 (2018-04-13)

• (Apollon77) Several fixes and optimizations
• (Apollon77) Upgrade node-ical library to allow big files to work
• (Apollon77) Better handling of full day events
• (Apollon77) Allow "Replace 0:00" to have 30 characters

1.5.3 (2018-03-24)

• (Apollon77) Also make location available in data table

1.5.2 (2018-03-23)

• (Apollon77/BuZZy1337) Fix several display issues

1.5.0 (2018-03-07)

• (bluefox) ready for Admin3

1.4.2 (2018-02-21)

• (Apollon77) Also display events that started before today

1.4.1 (2018-02-05)

• (Apollon77) also allow events without end parameter and assume an 0minute event then and set end = start

1.4.0 (2018-01-01)

• (Apollon77) allow multiple Events to be contained in one calendar entry. Make sure the names are unique enough because the search only checks for existance of the event name in the text.
• (Apollon77) correctly detect events that started before 0:00
• (Apollon77) also show events with no duration (sometimes used as reminders)
• (Apollon77) correctly show end times for events that are longer then 1 day (including "+x" to show day duration)
• (Apollon77) many enhancements and optimizations in formatting the infos (especially when event has already started but not ended)
• (Apollon77) add option to hide year numbers
• (Apollon77) add own CSS classes to each entry with the names iCal- and iCal-2 to be able to really design it as needed
• (Apollon77) Known issue: For recurring events it works to delete single events, but it do not work to move them

1.3.3 (2017-10-30)

• (DutchmanNL) Translate to Netherlands

1.3.2 (2017-02-24)

• (jens-maus) added singular form for 'days'

1.3.1 (2017-02-20)

• (jens-maus) implemented support for date excludes for recurring events

1.3.0 (2017-02-17)

• (jens-maus) switched ical module to use 'node-ical' which should improve ics format compatibility

1.2.2 (2017-02-17)

• (jens-maus) added changes to show "Noch X Tage" for fullday events (e.g. school holidays)

1.2.1 (2017-02-11)

• (jens-maus) applied workaround of ics files with TZID before DATE in DTSTART/DTEND

1.2.0 (2016-07-23)

• (bluefox) allow read from files
• (bluefox) add tests
• (bluefox) fix all day indication

1.1.3 (2016-07-19)

• (bluefox) fix error if entry is invalid
• (bluefox) use newer ical packet version

1.1.2 (2015-06-30)

• (jens-maus) implemented some more text replacement terms
• (jens-maus) we only colorize the date+time for imminent appointments
• (jens-maus) added cloneextend dependency definition and fix for dayafter mods
• (jens-maus) ported the "dayafter" change of the ccu.io ical adapter to the iobroker

1.1.1 (2015-08-16)

• (bluefox) enable auth only if user set.

1.1.0 (2015-08-13)

• (elmars) Added ability to provide username/password to authenticate against protected ics files. Tested with owncloud.

1.0.2 (2015-07-21)

• (bluefox) fix error if ICS file has empty lines

1.0.1 (2015-07-21)

• (bluefox) change readme title

1.0.0 (2015-07-21)

• (bluefox) fix error with set event to false

0.1.1 (2015-06-14)

• (bluefox) add additional fields for ioBroker.occ

0.1.0 (2015-03-24)

• (bluefox) make it compatible with new concept

0.0.2 (2015-02-22)

• (bluefox) fix error with configuration
• (bluefox) fix error with event object creation

0.0.1 (2015-02-17)

• (bluefox) initial commit

License

The MIT License (MIT)

Copyright (c) 2014-2020, bluefox [email protected]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.