Skip to content

ReferenceSkins

live-video-skin

The live video preset's default skin, which swaps time controls for a Live button

The default skin of the live video preset: the video layout with the time slider and time displays swapped for a Live button. NeutralLiveVideoSkin is the same preset’s other variant. See Skins for how packaged skins work and Presets for what the live video preset ships.

Import

import '@videojs/html/live-video/skin';

The import registers the skin and every UI element it composes. The CDN player bundle registers this skin together with its player:

<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.0.1/live-video.js"></script>

Anatomy

The skin goes between the player and the media component. It renders its controls around the media.

<live-video-player>
  <live-video-skin>
    <hls-video></hls-video>
  </live-video-skin>
</live-video-player>

This uses the lightweight HLS video element because most browsers can’t play HLS streams with a plain <video>. See Play live streams.

Poster

The skin renders a poster image before playback starts. An element with slot="poster" replaces it.

See Add a poster and loading placeholder for complete examples.

Styling

Packaged skins style themselves and expose a small set of public CSS custom properties. Everything else inside the skin is private and may change between releases. Customize skins documents the properties. For deeper changes, the Video.js registry provides the skin files.

Examples

Basic Usage

<live-video-player>
  <live-video-skin class="html-live-video-skin-basic">
    <hls-video src="https://stream.mux.com/v69RSHhFelSm4701snP22dYz2jICy4E4FUyk02rW4gxRM.m3u8" playsinline crossorigin="anonymous"></hls-video>
  </live-video-skin>
</live-video-player>

Own the UI

Packaged skins keep their controls and layout inside Video.js. When you need to add, remove, rearrange, or deeply restyle controls, use Shadcn to add the skin source to your project. Its components, layout, styles, and interactions become local files you can change.