CountdownTo

Track time until important deadlines, events, or milestones with visual progress indicators.

Features

• Create visual progress bars that count down to specific dates and times (support for minutes and seconds)
• Progress bars can be configured to run in realtime
• Multiple progress bar styles: Line, Circle, SemiCircle, and Square (from progressbar.js, support for custom shapes soon!)
• Customizable appearance
• Flexible date and time formatting using Luxon
• Custom info text with placeholders for dates, percentages, and durations
• Progress can be shown as forward progress or as a countdown
• Configurable completion messages

Installation

From Obsidian Community Plugins

1. Open Obsidian Settings
2. Go to Community Plugins and disable Safe Mode if necessary
3. Click "Browse" and search for "Countdown To"
4. Install the plugin and enable it

Manual Installation

1. Download the latest release from the GitHub releases page
2. Extract the files to your Obsidian vault's plugins folder: <vault>/.obsidian/plugins/countdown-to/
3. Reload Obsidian
4. Enable the plugin in Obsidian settings under Community Plugins

How to Use

Create a countdown progress bar by adding a code block with the countdown-to language identifier:

```countdown-to
title: Project Deadline
startDate: 2025-03-12T08:00:00
endDate: 2025-04-11T14:00:00
type: circle
color: #ff5722
trailColor: #f5f5f5
infoFormat: {percent}% complete - {remaining} until {end:LLL d, yyyy}
updateInRealTime: true
updateInterval: 30
```

Required Parameters

• endDate: The target date to count down to (ISO format: YYYY-MM-DDTHH:MM:SS)
• startDate: Start date for the progress calculation, needs to be now or in the past (ISO format: YYYY-MM-DDTHH:MM:SS)

Optional Parameters

• title: Title of the countdown (show above the progress bar)
• type: Progress bar type - line, circle, semicircle, or square (defaults to line)
• color: Color for the progress bar (HEX format)
• trailColor: Color for the incomplete part of the progress bar (HEX format)
• progressType: progress (default) or countdown
• onCompleteText: Text to display when the countdown is complete
• infoFormat: Custom format for the information text
• updateInRealTime: Whether to update the progress bar in real-time (true/false)
• updateInterval: How often to update the progress bar (in seconds)

Formatting Options

The infoFormat parameter supports various placeholders and Luxon formatting options:

Basic Placeholders

• {percent} - Percentage of completion
• {start} - Start date (ISO format)
• {end} - End date (ISO format)
• {current} - Current date (ISO format)
• {remaining} - Remaining time in human-readable format
• {elapsed} - Elapsed time in human-readable format
• {total} - Total duration in human-readable format

Luxon Formatting

You can format dates and durations using Luxon's formatting syntax:

• {start:format} - Format start date
• {end:format} - Format end date
• {current:format} - Format current date
• {remaining:format} - Format remaining duration
• {elapsed:format} - Format elapsed duration
• {total:format} - Format total duration

For example:

• {end:LLL d, yyyy} displays the end date as "Apr 11, 2025"
• {end:EEEE, MMMM d, yyyy} displays as "Thursday, April 11, 2025"

See the Luxon formatting reference for all available format tokens.

Configuration

You can configure default settings for all progress bars in the plugin settings:

1. Open Obsidian Settings
2. Navigate to the "Countdown To" plugin settings
3. Customize the default bar type, colors, progress type, update interval, and info format

All settings can be overridden in individual progress bar code blocks.

Performance Considerations

• Setting a very low update interval (e.g., 1 second) for many progress bars may impact performance
• You can set different update intervals for different progress bars based on their importance
• The default behavior is NOT updating progress bars in realtime, so keep this in mind.

License

This project is licensed under the GPL-3.0 License - see the LICENSE file for details.

Support

If you encounter any issues or have feature requests, please open an issue here on GitHub.

Credits

• Uses progressbar.js for rendering progress bars
• Uses Luxon for date and time handling