Dcal Upcoming Event

June 22, 2026 ยท View on GitHub

A Dank Material Shell plugin that shows your next calendar event from dcal with a live countdown timer.

screenshot

Features

  • Displays your next upcoming event name and countdown in the dank bar
  • Countdown format: XdYhZm, skipping zero sections (e.g. 2h15m, 1d3m)
  • Shows Now (in green) for the first 10 minutes of a running event
  • Shows <1m for events less than a minute away
  • Click the widget to toggle the dcal UI

Settings

SettingDescriptionRangeDefault
Refresh IntervalHow often to fetch events (seconds)10 - 12030
Max WidthMaximum width of the event name (pixels)80 - 300160
Look-AheadHow far ahead to look for events (days)1 - 71

Dependencies

Installation

Install from the DMS plugin browser, or manually:

git clone https://github.com/leoamaro01/dms-dcal ~/.config/DankMaterialShell/plugins/dcalUpcoming

Then reload plugins from DMS settings or restart the shell.

License

MIT