Skip to content

README.md

Latest commit

 

History

History
68 lines (48 loc) · 2.31 KB

README.md

File metadata and controls

68 lines (48 loc) · 2.31 KB

Time Until

DankMaterialShell plugin that displays a customizable countdown timer in the Dank Bar. Perfect for tracking important deadlines, goals, or any time-sensitive events.

Inspired by GNOME extension No Time For Caution.

Screenshots

Settings Horizontal Vertical
Plugin settings Horizontal pill Vertical pill

Features

  • Remaining time is displayed on the Dank Bar (horizontal).
  • Remaining time is recalculated:
    • On shell start.
    • When changing settings.
    • When enough time passes for each unit to tick down by 0.1 or once a day, whichever is first.
  • Time is shown with up to 1 decimal value.
  • Time is calculated against your OS time.
  • When the target date time passes, the widget shows the time overdue instead.

Installation

From Plugin Registry (recommended)

  1. Install from DMS Settings > Plugins > Browse. Make sure you've selected Show 3rd Party. If it doesn't appear, select the round arrow to refresh the list.
  2. Enable Time Until.
  3. In DMS settings go to Dank Bar > Widgets.
  4. Add Time Until to your Dank Bar widget list.

Alternatively, run:

dms plugins install timeUntil

Manual

  1. Copy this directory to ~/.config/DankMaterialShell/plugins/
  2. Open DMS Settings > Plugins
  3. Enable Time Until If it doesn't appear in the list, select Scan to detect it.
  4. In DMS settings go to Dank Bar > Widgets.
  5. Add Time Until to your Dank Bar widget list.

Settings

To get to the plugin settings:

  1. Open DMS Settings > Plugins.
  2. Select the down chevron next to Time Until.

These settings are available:

  • Target Date - Date to count down to, in the format <YYYY>-<MM>-<DD> <hh>:<mm>, for example 2026-04-10 21:37. Time component is optional and defaults to midnight if omitted.
  • Unit - Whether to use hours, days, weeks, or months. Default: days.
  • Label - Text to show after the units. Default: "remaining". Changes to "overdue" when the target date is in the past.

Usage

  • In the bar: Observe time counting down to your set date (or up from it if overdue).
  • Click the widget: See a popout with your target date.