# bytedance/xgplayer

A HTML5 video player with a parser that saves traffic

Repository: https://github.com/bytedance/xgplayer
Canonical: https://ross.abutalabs.com/products/xgplayer
Homepage: https://h5player.bytedance.com/
Language: JavaScript
License: MIT
License Family: permissive
Topics: mp4, mp4box, fmp4, hls-player, flv-parser, dash, video-player, hls, flv, video, player, videoplayer, html5-video, html5-video-player
Last push: 2026-08-20T03:49:29+00:00

## Health v2 (maintenance only)
Score: 85/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 61, longevity 100
- inputs: {"age_days": 3031, "days_push": 13, "days_rel": 49, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 9283, forks 942 (observed 2026-08-28T04:10:30.292330+00:00)

## What it is
xgplayer is a web HTML5 video player library by ByteDance with a componentized, detachable UI and built-in parsers for MP4, HLS, FLV, and DASH. It supports staged loading of non-streaming MP4 to enable seamless quality switching, load control, and bandwidth savings, with an extensible plugin system.

## Use cases
- play mp4 videos in the browser with a customizable html5 player
- play hls live and on-demand streams in a web app
- play flv streams in the browser
- seamlessly switch video quality without interruption
- reduce bandwidth when serving non-streamable mp4 files
- build a video site with a plugin-based player ui
- parse mp4, hls, and flv at the player level instead of server-side transcoding

## When to choose
- you need a flexible, componentized html5 player with deep format control
- you serve mostly mp4 vod and want staged loading and bandwidth savings
- you need unified mp4/hls/flv/dash support from one library
- you want seamless clarity switching and error monitoring built in

## When to avoid
- you need DRM-protected or Widevine/FairPlay content
- you need native mobile app players rather than web playback
- you prefer a minimal player without a plugin ecosystem
- your project is not JavaScript/browser based

## Facets
- artifact type: library
- maturity: active
- function: video-processing, ui-components, plugin-system, parser
- domain: web-development, frontend, media
- platform: browser, cross-platform
- tags: html5-video-player, hls, flv, mp4, dash, streaming, video-player, javascript, video, web-server

## Member repositories
- bytedance/xgplayer (main) score 85

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:30.292330+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-29T17:22:33.579566+00:00, confidence not recorded.
  - readme: https://github.com/bytedance/xgplayer (fetched 2026-08-28T04:10:30.292330+00:00, sha f9952ecc4c9d)
  - homepage: https://h5player.bytedance.com/ (fetched 2026-08-29T08:23:08.408786+00:00, sha 57a255af81a4)
  - site_page: https://h5player.bytedance.com/about (fetched 2026-08-29T08:23:08.418632+00:00, sha 3aa5f40b8678)
- Data as of 2026-08-30T08:39:29.467469+00:00.