# zhihu/griffith

A React-based web video player

Repository: https://github.com/zhihu/griffith
Canonical: https://ross.abutalabs.com/products/griffith
Homepage: https://codesandbox.io/embed/p03wm0o80
Language: TypeScript
License: MIT
License Family: permissive
Topics: zhihu, mp4, fmp4, hls, react, video, mp4box, html5-video, html5-video-player, zhihu-video-player, react-components
Last push: 2026-06-15T10:48:35+00:00

## Health v2 (maintenance only)
Score: 62/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 87, release rhythm 8, longevity 100
- inputs: {"age_days": 2721, "days_push": 79, "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 2507, forks 226 (observed 2026-08-28T04:06:57.186960+00:00)

## What it is
Griffith is a React-based web video player library developed by Zhihu, supporting mp4 and HLS streaming via Media Source Extensions. It ships as a React component plus a standalone UMD build for non-React applications.

## Use cases
- play mp4 and hls videos in a react app
- add a video player component to my website
- stream video with media source extensions
- embed a video player without react
- support quality switching hd sd video playback
- build a custom html5 video player ui

## When to choose
- you need a React video player with mp4/HLS MSE-based streaming
- you want a battle-tested player used in production at Zhihu
- you need a standalone UMD player for non-React pages

## When to avoid
- your app uses server-side rendering, which is not supported
- you need DRM or advanced adaptive streaming features beyond mp4/HLS
- you need a player for non-web platforms like native mobile

## Facets
- artifact type: library
- maturity: maintenance
- function: video-processing, ui-components, frontend-framework
- domain: web-development, frontend, media
- platform: browser
- tags: react, video-player, hls, mp4, mse, html5-video, streaming, video, nodejs, web-server

## Member repositories
- zhihu/griffith (main) score 62

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:57.186960+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-30T02:26:42.102155+00:00, confidence not recorded.
  - readme: https://github.com/zhihu/griffith (fetched 2026-08-28T04:06:57.186960+00:00, sha 78170bd061c6)
  - homepage: https://codesandbox.io/embed/p03wm0o80 (fetched 2026-08-29T10:08:55.405295+00:00, sha 6334d7ad6bb2)
- Data as of 2026-08-30T08:39:29.467469+00:00.