Clock applet multiple data sources

.github/workflows/build.yml

@@ -26,10 +26,13 @@ env:
     libatk1.0-dev
     libcairo2-dev
     libdconf-dev
+    libecal2.0-dev
+    libedataserver1.2-dev
     libgirepository1.0-dev
     libglib2.0-dev
     libgtk-3-dev
     libgtk-layer-shell-dev
+    libical-dev
     libice-dev
     libmate-desktop-dev
     libmate-menu-dev
@@ -69,13 +72,15 @@ env:
     ccache
     autoconf-archive
     clang
+    evolution-data-server
     gcc
     git
     glib2-devel
     gobject-introspection
     gtk-layer-shell
     itstool
     libcanberra
+    libical
     libmateweather
     libsm
     libwnck3
@@ -258,6 +263,7 @@ jobs:
             -DHAVE_X11 -DHAVE_RANDR
             -DHAVE_WAYLAND
             -DCLOCK_INPROCESS -DFISH_INPROCESS -DNOTIFICATION_AREA_INPROCESS -DWNCKLET_INPROCESS
+            -DHAVE_EDS -DHAVE_LIBICAL -DLIBICAL_GLIB_UNSTABLE_API
             -DHAVE_LANGINFO_H -DHAVE_NL_LANGINFO
             -DGETTEXT_PACKAGE="mate-panel"
             -D__STDC_VERSION__=201112 -D_Noreturn=__attribute__((__noreturn__))
@@ -267,6 +273,8 @@ jobs:
             gmodule-2.0
             gtk+-3.0
             ice
+            libecal-2.0
+            libical-glib
             libwnck-3.0
             mate-desktop-2.0
             sm

README

@@ -53,6 +53,19 @@ libmateweather-dev
 For work-in-progress Wayland support
 gtk-layer-shell (https://github.com/wmww/gtk-layer-shell)
 
+Optional dependencies
+=====================
+
+Evolution Data Server (EDS) — calendar and task integration in the Clock applet:
+libecal-2.0 >= 3.33.2
+libedataserver-1.2 >= 3.5.3
+Enable with: --enable-eds (default: auto-detect)
+
+libical-glib — vdir calendar support in the Clock applet (independent of EDS):
+libical-glib >= 3.0
+Enable with: --enable-libical (default: auto-detect)
+See applets/clock/README.md for details on the vdir calendar feature.
+
 How to report bugs
 ==================
 

applets/clock/Makefile.am

@@ -35,13 +35,23 @@ CLOCK_SOURCES = 		\
 	set-timezone.h		\
 	$(BUILT_SOURCES)
 
-if HAVE_EDS
 CLOCK_SOURCES += \
 	calendar-client.c	\
 	calendar-client.h	\
-	calendar-sources.c	\
-	calendar-sources.h	\
+	calendar-provider.c	\
+	calendar-provider.h	\
 	calendar-debug.h
+
+if HAVE_LIBICAL
+CLOCK_SOURCES += \
+	calendar-vdir-provider.c	\
+	calendar-vdir-provider.h
+endif
+
+if HAVE_EDS
+CLOCK_SOURCES += \
+	calendar-eds-provider.c		\
+	calendar-eds-provider.h
 endif
 
 CLOCK_CPPFLAGS =						\
@@ -53,6 +63,10 @@ CLOCK_CPPFLAGS =						\
 	-DMATELOCALEDIR=\""$(datadir)/locale"\"	\
 	-DMATEWEATHER_I_KNOW_THIS_IS_UNSTABLE
 
+if HAVE_LIBICAL
+CLOCK_CPPFLAGS += $(LIBICAL_CFLAGS) -DLIBICAL_GLIB_UNSTABLE_API
+endif
+
 if HAVE_EDS
 CLOCK_CPPFLAGS += $(EDS_CFLAGS)
 endif
@@ -64,6 +78,10 @@ CLOCK_LDADD =						\
 	libsystem-timezone.la				\
 	-lm
 
+if HAVE_LIBICAL
+CLOCK_LDADD += $(LIBICAL_LIBS)
+endif
+
 if HAVE_EDS
 CLOCK_LDADD += $(EDS_LIBS)
 endif

applets/clock/README.md

@@ -0,0 +1,93 @@
+# Clock Applet
+
+The clock applet displays the time and date in the MATE panel. When clicked,
+it opens a calendar window that can also show upcoming appointments and tasks
+from calendar data sources.
+
+## Calendar Data Sources
+
+The applet supports two calendar backends, which can be active simultaneously.
+
+### Evolution Data Server (EDS)
+
+When built with `--enable-eds` and the `libecal-2.0` / `libedataserver-1.2`
+libraries are present, the applet reads appointments and tasks directly from
+Evolution Data Server. This gives access to any calendar or task list
+configured in GNOME Online Accounts or Evolution.
+
+The "Show calendar events" and "Show tasks" checkboxes in the applet
+preferences control whether each type of data is displayed.
+
+### vdir / vdirsyncer
+
+When built with `--enable-libical` and `libical-glib >= 3.0` is present, the
+applet can read calendars stored in **vdir format** — a directory of `.ics`
+files as produced by [vdirsyncer](https://vdirsyncer.readthedocs.io/).
+
+#### Auto-discovery
+
+The applet automatically scans `$XDG_DATA_HOME/vdirsyncer/` (typically
+`~/.local/share/vdirsyncer/`) for vdir collections. This matches the default
+storage path used by vdirsyncer. No configuration is needed if vdirsyncer is
+set up with its default paths.
+
+#### Additional paths
+
+Extra collection directories can be added via GSettings:
+
+```
+gsettings set org.mate.panel.applet.clock vdir-calendar-paths \
+  "['/path/to/collection1', '/path/to/collection2']"
+```
+
+Each path should point directly to a directory containing `.ics` files
+(a single vdir collection), not to a parent directory.
+
+#### Setting up vdirsyncer
+
+Install vdirsyncer and create `~/.vdirsyncer/config`:
+
+```ini
+[general]
+status_path = "~/.vdirsyncer/status/"
+
+[pair my_calendar]
+a = "my_local"
+b = "my_remote"
+collections = ["from b"]
+conflict_resolution = "b wins"
+
+[storage my_local]
+type = "filesystem"
+path = "~/.local/share/vdirsyncer/my_calendar/"
+fileext = ".ics"
+
+[storage my_remote]
+type = "caldav"
+url = "https://your-caldav-server/path/"
+username = "user@example.com"
+password = "yourpassword"
+```
+
+Then run:
+
+```
+vdirsyncer discover my_calendar
+vdirsyncer sync
+```
+
+The applet will pick up the synced events automatically on next start. Live
+updates are detected via `GFileMonitor` — new or changed `.ics` files are
+reflected in the calendar window without restarting the applet.
+
+#### Recurring events
+
+Recurring events (RRULE, RDATE, EXDATE) are fully expanded using libical-glib,
+so repeating events appear correctly on each occurrence date.
+
+#### Collection metadata
+
+If a vdir collection directory contains a `displayname` file, its contents
+are used as the backend name shown in event tooltips. A `color` file
+(containing an `#RRGGBB` hex color) is used to color-code events from that
+collection in the calendar window.