Skip to content

countdown

0.6.0Package record

A Countdown Timer for HTML Presentations, Documents, and Web Apps

0packages depend
6.1Kdownloads / year
61.3%test coverage
13/13flavors OK

Overview

About

A simple countdown timer for slides and HTML documents written in 'R Markdown' or 'Quarto'. Integrates fully into 'Shiny' apps. Countdown to something amazing.

Changes in 0.6.0

Breaking changes

  • The first countdown() timer no longer provides global styles for all other countdown timers. Instead, use countdown_style() with the same style-related arguments to set global styles for all countdown timers. (#36)

New features and improvements

  • The countdown JavaScript implementation was entirely re-written as a custom <countdown-timer> element. This improves lifecycle management of the timer component, making it possible to use countdown timers with dynamic UI in Shiny apps. (#59)
  • Rewritten countdown timer CSS now uses CSS variables rather than a template rendered in R. This improves how countdown's dependencies are handled and makes it easier to customize and use countdown in other projects and settings. (#36)
Show all changes in 0.6.0Hide the rest of the changes in 0.6.0
  • Implemented emitting of native browser events alongside Shiny communication. (#37)
  • Added two new event types: "finished" when the timer completes its cycle and "warning" when it reaches the warning period. (#37)
  • Set class = "inline" in countdown() to create an inline, rather than absolute-positioned, countdown timer. (#36)
  • Set class = "no-controls" in countdown() to create a countdown timer without the controls. (#40)

Bug fixes

  • Fixed an issue where custom URLs for play_sound were not used for the timer end sound. (thanks @jannismain, #38)
  • Fixed countdown_fullscreen() not passing along class and start_immediately parameters. (#43)

Changes

  • Switched to using {bslib} to stylize the demo countdown shiny app. (#37)
  • Clarified play_sound documentation to emphasize custom sounds require the countdown clock to be embedded in a website, presentation, or Shiny app to be played due to JavaScript limitations on local files. (#44)

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 59 s · r-oldrel-windows-x86_64
Status changes
  • OK13 OK2026-08-05
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK13 OK2026-06-09
  • WARNING12 OK, 1 WARNING2026-06-08
  • OK14 OK2026-03-10
Advisories

none known

Documentation

In release 0.6.0
READMEYes · 101 wordsVignettesNoNEWSYes · 100% structured · mentions 0.6.0Citation fileNoWebsiteYes
Help pages
6 (1 internal)includes a package overview page
Examples that run
100%3 run in a plain check (3 of them under a condition)
Exported functions with examples
60%
Documented parameters
99%
Return-value docs
100%
Help pages citing references
0%

Downloads

6.1K
CRAN downloads in the past year
Rank #6,813 · ~17/day · ~510/mo
Daily download trend is not available in this view yet.
45730 days
1.3K90 days
6.1K1 year
Compare downloads with other packages →
Also on240 r2u8 autocran

Repository

159Stars
16Forks
7Open issues
3Open PRs
5Releases
304Commits
5Commit identities
rstatsrmarkdownxaringanslidescountdown-timerhtmlquarto-extensionquarto-slides
304 commits · Last activity 2025-11-15 · 0% stars, 30d
Responsiveness
How these are sampled
PRs merged (all time)
92%
Median days to close, 50 most recently updated closed issues
11
Median days to close, 50 most recently updated closed PRs
1

Stars over time

2025-08-22 · 1492026-09-23 · 159
PracticesBeta

7 development-tooling and community-health practices detected across 4 families in the upstream repository

Checks run against github.com/gadenbuie/countdown on 2026-10-21.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Docs source (2)

GitHub Pages site last deployed 2025-11-15 · The repository has a site deploy workflow

Reproducibility and dev environment (2)
MakefileDev Container
Lint, format, editor (1)
VS Code
How this is detected·Detection ruleset v4 (2026-10-20)

Dependencies

Declared dependencies
5 external dependencies (excludes base and recommended)

Installing countdown adds 7 packages (6 with compiled code, 3.0 MB of source tarballs). Heaviest: farver 1.2 MB, rlang 766 KB, prismatic 640 KB.

Depends (0)
none
Imports (3)
LinkingTo (0)
none
Enhances (0)
none
Reverse dependencies
0direct
0indirect

Nothing depends on this yet.

People & History

People (1)
Author, Maintainer since 0.4.0 (2022), Copyright holder
Releases (2)

Pick two releases to compare their code metrics.

  • R
    R 4.6.0 released · 2026-04-24
  • 0.6.0Latest
    record
    2025-11-14 · current release · diff ↗ ·
    added 1 export
    countdown_style
  • R
    R 4.5.0 released · 2025-04-11
  • R
    R 4.4.0 released · 2024-04-24
  • R
    R 4.3.0 released · 2023-04-21
  • 0.4.0
    record
    2022-08-16
  • R
    R 4.2.0 released · 2022-04-22

Package metadata

First published
2022-08-16
Total releases
2 / 4 yrs
License
MIT + file LICENSE OSI
Download size
382 KB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("countdown")
Aden-Buie, G. (2025). countdown: A Countdown Timer for HTML Presentations, Documents, and Web Apps (Version 0.6.0) [Computer software]. https://doi.org/10.32614/CRAN.package.countdown

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for countdown version 0.6.0 [Data set]. HJJB, LLC. Data release v2026-10-24. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-24, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy