# ngryman/reading-time

:books: Medium's like reading time estimation.

Repository: https://github.com/ngryman/reading-time
Canonical: https://ross.abutalabs.com/products/reading-time
Homepage: https://ngryman.sh
Language: TypeScript
License: MIT
License Family: permissive
Topics: reading-time, medium, estimate
Last push: 2025-04-22T20:41:27+00:00

## Health v2 (maintenance only)
Score: 30/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 17, release rhythm 8, longevity 100
- inputs: {"age_days": 4548, "days_push": 498, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1429, forks 47 (observed 2026-08-28T04:04:42.164146+00:00)

## What it is
A small TypeScript library that estimates how long a piece of text will take to read, in the style of Medium's reading time indicator. It works with plain text, markdown, and HTML, and supports both string input and streaming analysis.

## Use cases
- estimate reading time for blog posts
- show 'x min read' on articles like Medium
- count words in markdown or html content
- compute reading time from a file stream
- customize words-per-minute for reading estimates

## When to choose
- you need a lightweight, fast reading-time estimator for Node.js or the browser
- your content is plain text, markdown, or HTML and approximate counts are acceptable
- you want streaming word-count analysis of large files

## When to avoid
- you need precise word extraction from complex markup or rich document formats
- you need readability scoring or other text analytics beyond word count and time
- you need support for languages without space-delimited words

## Facets
- artifact type: library
- maturity: stable
- function: nlp, developer-tools
- domain: web-development, developer-tools
- platform: browser
- tags: reading-time, word-count, medium, estimation, typescript, natural-language-processing, nodejs, javascript

## Member repositories
- ngryman/reading-time (main) score 30

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:42.164146+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:37:16.483442+00:00, confidence not recorded.
  - readme: https://github.com/ngryman/reading-time (fetched 2026-08-28T04:04:42.164146+00:00, sha cac6270927e4)
  - registry_npm: https://registry.npmjs.org/reading-time (fetched 2026-08-29T11:49:06.240360+00:00, sha fff5c9b4a9ff)
- Data as of 2026-08-30T08:39:29.467469+00:00.