LifeClock
Live: https://theguysaccount.github.io/lifeclock/ · Screens: docs/screens
Your life, counted in seconds. Enter a birthday, sex and country, and LifeClock shows a live count of the seconds ahead of you, on average, from public life tables: the U.S. Social Security Administration's for the US, and the World Health Organization's for 184 other countries and the world. It's an average, not a prediction, and it says so.
- Live counter that ticks every second, with everyday units (sunrises, weekends, full moons).
- Time lived mode that counts up instead, for anyone who'd rather not see a countdown.
- Share card drawn in the browser (1080×1080 PNG) with just the number.
- Desk mode: a full-screen clock for a spare screen; settings live after the "#" and never reach a server.
- Billion-second birthday calculator.
- Life expectancy pages for 185 countries and the world: average years left at every age, by sex.
- Nothing stored: no accounts, cookies, storage or analytics by default. Crisis-line links on every page.
How it runs
| What | Where | When |
|---|
| Validate, test, build, drive in headless Chrome, deploy, smoke-test, IndexNow | .github/workflows/pages.yml | every push |
| Fetch WHO (and try SSA) life tables, validate, commit, redeploy | .github/workflows/refresh.yml | monthly |
| Live end-to-end test, page and table checks, keep-alive | .github/workflows/selftest.yml | weekly |
Failure handling and the keys for the domain, analytics and posters: OPERATIONS.md.
Layout
data/ssa.json, data/who.json life tables (refreshed by refresh.yml), data/countries.json names and ISO codes
pipeline/lifetables.py fetch, parse and validate the WHO and SSA tables
pipeline/reference.py the model in Python (independent of the JS; the tests compare them)
pipeline/build.py static site generator (standard library only) -> dist/
site/assets/core.js the model in the browser; app.js the UI; selftest.js the end-to-end driver
scripts/ e2e.sh, screens.sh, og.py, indexnow.py, check_live.py, keepalive.sh
tests/ Python tests (tables, model, build) and tests/js (model, parity)
Run, test, deploy
Python 3.9+, Google Chrome, Node 18+ for the JS tests.
python3 pipeline/build.py && python3 -m http.server -d dist 8000 # http://localhost:8000
python3 -m unittest discover -s tests
node --test tests/js/*.test.mjs
scripts/e2e.sh
Deploy is a push to main.
Model
Exact age is time since local midnight on the birthday, in 365.2425-day years. Remaining years come from the SSA's single-year table (US; linear between ages) or the WHO's table at ages 0, 1, 5 … 85 (linear between; past 85, the WHO value follows the SSA curve's shape). "Prefer not to say" uses the WHO both-sexes table, or the average of the SSA's two tables. The clock counts down to the moment you pressed start plus those years.
License
Code: MIT. Life tables: SSA (U.S. government work, public domain) and WHO (CC BY-NC-SA 3.0 IGO); the derived data/who.json and dist/data/tables.json are shared under CC BY-NC-SA 3.0 IGO.
