A DankBar widget that shows upcoming CalDAV calendar events with a full popout panel for viewing, creating, editing, and deleting events.
- Works with iCloud, Google, Nextcloud, and any CalDAV server
- Auto-discovery of all calendars under a CalDAV account
- GNOME Keyring integration (falls back to plaintext config if unavailable)
- Create, edit, and delete events directly from the popout
- Desktop notifications before upcoming events
- Per-calendar name display and event location display
- Configurable look-ahead window and refresh interval
- Horizontal pill: shows the next upcoming event with time and title (e.g.
14:00 Meeting) - Vertical pill: shows the total event count with a "cal" label
- Grouped event list by day with time ranges
- Color-coded all-day and timed events
- Click an event to edit title, time, and location
- Add new events with calendar selection, date/time pickers, and optional location
- Last updated timestamp
| Setting | Description | Default |
|---|---|---|
| CalDAV URL | Base URL of your CalDAV server (calendars are auto-discovered) | — |
| Username | CalDAV account username | — |
| Password | App-specific password (stored in GNOME Keyring when available) | — |
| Look-ahead (days) | How many days into the future to show events | 7 |
| Refresh interval (minutes) | How often to fetch events from the server | 5 |
| Show event location | Display location for events that have one | On |
| Show calendar name | Display which calendar each event belongs to | Off |
| Desktop notifications | Send a notification before upcoming events | On |
| Notify before (minutes) | How far in advance to notify | 15 |
Multiple CalDAV providers can be configured by editing ~/.config/qcal/config.json directly.
python3go(build-time only, for compiling qcal)secret-tool(optional, for GNOME Keyring password storage)
git clone --recurse-submodules https://github.com/szabolcsf/dms-qcal-calendar.git
cd dms-qcal-calendar
./setup.sh # builds the qcal binary
cp -r . ~/.config/DankMaterialShell/plugins/qcalCalendarThen enable the plugin in DMS Settings → Plugins, and add it to your DankBar. Configure your CalDAV account in the plugin settings.
Tested on Niri. Should work on any compositor supported by DankMaterialShell.
MIT