Skip to main content
Version: 7.11

Countdown

Display the remaining days, hours, minutes, and seconds until any target date. No API key required.

Overview​

The Countdown plugin shows the remaining time until a target date and time you set:

  • Days, hours, minutes, and seconds remaining
  • Automatically detects when the event has passed
  • Timezone-aware — configure any IANA timezone
  • Values update on every board refresh

Setup​

  1. Open http://localhost:4420
  2. Go to the Integrations page
  3. Toggle Countdown on
  4. Click Configure and set the event name, target date/time, and timezone
  5. Click Save Changes
tip

Countdown requires no external service or API key. All values are computed locally.

Available Variables​

VariableDescriptionExample
{{countdown.event_name}}Configured event nameLast Day of School
{{countdown.target_datetime}}Target datetime (ISO 8601)2027-01-01T00:00:00
{{countdown.days}}Whole days remaining86
{{countdown.hours}}Hours remaining (0–23)14
{{countdown.minutes}}Minutes remaining (0–59)30
{{countdown.seconds}}Seconds remaining (0–59)45
{{countdown.total_seconds}}Total seconds until target7473045
{{countdown.formatted}}Pre-formatted summary86D 14H 30M
{{countdown.is_expired}}"true" once the target has passedfalse

Example Templates​

Classic countdown:

{center}COUNTDOWN UNTIL
{{countdown.event_name}}

{{countdown.days}} DAYS
{{countdown.hours}} HOURS
{{countdown.minutes}} MINUTES

Compact:

{center}{{countdown.event_name}}
{{countdown.days}}D {{countdown.hours}}H {{countdown.minutes}}M

Days only:

{center}{{countdown.days}} DAYS UNTIL
{{countdown.event_name}}

Next Steps​