Step By Step Tutorial

1. Install

cd <Your MagicMirror directory>/modules
git clone https://github.com/MMRIZE/MMM-CalDAV
cd MMM-CalDAV
npm install

2. There would be .env (It would be hidden, so you should check it with ls -al or equivalent for your environment/OS)

If not there, copy it from env.example

cp env.example .env

3. Open your Synology Calendar. You can open it from your Synology Package Center Or installed app lists. Usually it will have http(s)://<IP_OR_URL>:<PORT(5000 or 5001)>/?launchApp=SYNO.Cal.Application as URL so you can open it on the browser.

You will see something like this.

4. Get the CadDAV account. Copy or memo the URL. Usually URL will have http(s)://<IP_OR_URL>:<PORT_5000_OR_5001>/caldav/ format.

5. Back to the terminal. Open the .env file with your favourite editor. Then, fulfil these lines.

6. Then configure the MMM-CalDAV module and the calendar module like this.

Carefully See the configuration of the calendar module.

7. Then run the MagicMirror. At the very first execution, some time would be needed for CalDAV calendars to be reflected on the screen. So, just stop the MagicMirror.

If CalDAV calendars would be success to be derived, the log will say something like this.

[2024-09-03 22:52:01.461] [LOG]   [CALDAV] File: SYNOLOGY_test.ics is refreshed.

And there be files to be hosted in the service directory like these;

I have two calendars, My Calendar and test, so there would be 2 hidden ics files generated, service/.SYNOLOGY_My_20Calendar.ics and service/.SYNOLOGY_test.ics.

But the real URL consumed by the calendar module would be http://localhost:8080/CALDAV/SYNOLOGY_test.ics, don't be confused.

8. Rerun the MM again. Now on the screen, your hosting calendar will be served.