A Countdown Timer for HTML Presentations, Documents, and Web Apps
Overview
A simple countdown timer for slides and HTML documents written in 'R Markdown' or 'Quarto'. Integrates fully into 'Shiny' apps. Countdown to something amazing.
Breaking changes
- The first
countdown()timer no longer provides global styles for all other countdown timers. Instead, usecountdown_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"incountdown()to create an inline, rather than absolute-positioned, countdown timer. (#36) - Set
class = "no-controls"incountdown()to create a countdown timer without the controls. (#40)
Bug fixes
- Fixed an issue where custom URLs for
play_soundwere not used for the timer end sound. (thanks @jannismain, #38) - Fixed
countdown_fullscreen()not passing alongclassandstart_immediatelyparameters. (#43)
Changes
- Switched to using
{bslib}to stylize the demo countdown shiny app. (#37) - Clarified
play_sounddocumentation to emphasize custom sounds require thecountdownclock 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
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK13 OK2026-06-09
- WARNING12 OK, 1 WARNING2026-06-08
- OK14 OK2026-03-10
Documentation
- 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
Repository
- 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
Forks over time
Releases over time
Issues over time
PRs over time
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.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2025-11-15 · The repository has a site deploy workflow
Dependencies
Code & Tests
People & History
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- 0.6.0Latest
- RR 4.5.0 released · 2025-04-11
- RR 4.4.0 released · 2024-04-24
- RR 4.3.0 released · 2023-04-21
- 0.4.02022-08-16
- RR 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")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.
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.