# Media Video Player

Custom video player with captions, chapters, playback speed and picture in picture.

- id: `media-video-player`
- Page: https://agentic-ui-kit.com/components/media-video-player
- Live preview: https://agentic-ui-kit.com/live/component/media-video-player?piece=media-video-player

## Install

```bash
agentic-ui add media-video-player
npx shadcn@4.17.0 add @agentic-ui/media-video-player
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** video-player, custom-controls, seek-bar, seek-time-preview, volume, playback-speed, captions-webvtt, chapters, picture-in-picture, fullscreen, keyboard-shortcuts, dark-mode
- **Intents:** explore-detail, communicate
- **Suits domains:** media, education, marketing, social, knowledge
- **Interaction:** click, drag, keyboard-navigation, hover
- **Screen role:** detail
- **Density:** comfortable
- **Dark mode:** yes
- **Use it for:** custom video player with captions, chapters, playback speed and picture in picture, accessible HTML5 video controls with keyboard shortcuts and a seek preview, course lesson or product walkthrough video with a chapter list, video component over a native video element with no third party player
- **Avoid when:** a live video call with participants (use collab-video-call-panel), streaming protocols such as HLS or DASH, which need a media library, audio only content (use media-audio-waveform), selecting a time range of a clip (use media-clip-range-selector)
- **Preserve when adapting:** controls-below-video, key-routing-by-target, local-vtt-blob
- **Replace when adapting:** src, poster, captions, chapters
- **Adaptation effort:** low
- **Coupling:** low
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** button
- **npm dependencies:** lucide-react
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-primitives