dms-dankcalendar

August 15, 2026 · View on GitHub

A DankMaterialShell bar widget for dcal / DankCalendar: your next event with a live countdown in the bar, and a scrollable agenda one click away.

Fork of leoamaro01/dms-dcal with the click model of dms-dankmail.

Screenshot

The agenda popout: shaded day headers, today tinted, happening-now events in green, past events dimmed, and a floating Today chip to jump back when you scroll away.

Behavior

ActionResult
Left clickAgenda popout, opened at today
Click an event in the popoutOpens that event's details in DankCalendar
+ in the popout headerOpens DankCalendar in day view to create an event
Right clickRefreshes the countdown and the agenda
Middle clickToggles the DankCalendar window
HoverPrivacy-conscious event card with schedule, location, a short description and link availability

The agenda covers a configurable window (default 7 days back, 30 ahead), grouped by day with shaded headers — today tinted, happening-now events in green, past events dimmed — and a divider each time the week changes. It always opens scrolled to today.

The bar pill keeps everything from upstream dms-dcal: scrolling event name, dot separator, live countdown ("2h30m", "Now" while an event is starting), compact vertical-bar layout, and the hover tooltip.

Pill in a vertical bar with the agenda popout

Requirements

  • dcal (DankCalendar daemon with IPC) running
  • jq

Install

git clone https://github.com/arqueon/dms-dankcalendar \
  ~/.config/DankMaterialShell/plugins/dankCalendarAgenda

Then Settings → Plugins → Scan for Plugins, enable Dank Calendar Agenda, and add it to a DankBar section.

The install directory must be named dankCalendarAgenda — the widget resolves its helper scripts through that path.

Settings

  • Refresh Interval — how often to re-fetch events (seconds)
  • Dynamic Width — shrink the pill to fit the event name
  • Hover Tooltip — toggle the next-event hover tooltip
  • Event Name Width — max pill width for the event name
  • Now Duration — how long to show "Now" after an event starts
  • Agenda: Days Back — past days kept scrollable in the popout (0–90, default 7)
  • Agenda: Days Ahead — upcoming days the popout covers (7–90, default 30)
  • Look Ahead — how many days ahead the countdown searches

License

GPL-3.0-or-later. The upstream code this plugin forks from is MIT © Leonardo Amaro — see LICENSE.upstream.

Credits