---
name: "@limeplay"
slug: "limeplay"
description: "Limeplay is an open-source React UI library for building custom video player interfaces, powered by Shaka Player (Google's adaptive-streaming engine) and distributed as a shadcn/ui-style copy-paste registry. Components cover the full player shell: Controls, Progress/Timeline, Playback, Track selector, Volume, Caption, and more. Designed to replace heavy black-box video player SDKs with composable, Tailwind-styled primitives you own. Install via npx shadcn add @limeplay/video-player. Use for: React projects that need a fully customizable HLS/DASH video player UI that integrates naturally with an existing shadcn/ui design system."
category: "Niche/single-purpose"
tags: ["audio", "cards", "components", "design-system", "forms", "hooks", "icons", "loaders", "media"]
framework: "react"
license: "MIT"
author: "winoffrg"
website: "https://limeplay.winoffrg.dev"
github: "https://github.com/winoffrg/limeplay"
registry: "https://limeplay.winoffrg.dev/r/registry.json"
pro: false
pro_url: null
github_stars: 276
component_count: 51
generated_at: "2026-07-28T08:00:50.948Z"
---

# @limeplay

Limeplay is an open-source React UI library for building custom video player interfaces, powered by Shaka Player (Google's adaptive-streaming engine) and distributed as a shadcn/ui-style copy-paste registry. Components cover the full player shell: Controls, Progress/Timeline, Playback, Track selector, Volume, Caption, and more. Designed to replace heavy black-box video player SDKs with composable, Tailwind-styled primitives you own. Install via npx shadcn add @limeplay/video-player. Use for: React projects that need a fully customizable HLS/DASH video player UI that integrates naturally with an existing shadcn/ui design system.

## Links

- Website: https://limeplay.winoffrg.dev
- GitHub: https://github.com/winoffrg/limeplay
- Registry JSON: https://limeplay.winoffrg.dev/r/registry.json
- Directory page: https://sh4dcn.vercel.app/registry/limeplay
- This file: https://sh4dcn.vercel.app/md/limeplay.md

## Install

```sh
# add the whole registry (shadcn CLI)
npx shadcn@latest add https://limeplay.winoffrg.dev/r/registry.json
pnpm dlx shadcn@latest add https://limeplay.winoffrg.dev/r/registry.json
bunx shadcn@latest add https://limeplay.winoffrg.dev/r/registry.json
# clone the source repo
git clone https://github.com/winoffrg/limeplay.git
# fetch the raw registry index
curl -s https://limeplay.winoffrg.dev/r/registry.json
```

## Components (51)

| name | type | description | install |
| --- | --- | --- | --- |
| index | registry:style | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/index.json` |
| error-screen | registry:ui | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/error-screen.json` |
| fallback-poster | registry:ui | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/fallback-poster.json` |
| mute-control | registry:ui | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/mute-control.json` |
| media-provider | registry:ui | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/media-provider.json` |
| player-layout | registry:ui | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/player-layout.json` |
| media | registry:ui | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/media.json` |
| volume-control | registry:ui | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/volume-control.json` |
| playback-control | registry:ui | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/playback-control.json` |
| picture-in-picture-control | registry:ui | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/picture-in-picture-control.json` |
| playback-rate | registry:ui | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/playback-rate.json` |
| timeline-labels | registry:ui | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/timeline-labels.json` |
| timeline-control | registry:ui | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/timeline-control.json` |
| limeplay-logo | registry:ui | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/limeplay-logo.json` |
| root-container | registry:ui | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/root-container.json` |
| captions | registry:ui | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/captions.json` |
| seek-controls | registry:ui | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/seek-controls.json` |
| video-player | registry:block | Modern seamless flat video player | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/video-player.json` |
| audio-player | registry:block | Compact audio player with playlist support | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/audio-player.json` |
| utils | registry:lib | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/utils.json` |
| time | registry:lib | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/time.json` |
| use-media | registry:hook | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/use-media.json` |
| use-volume | registry:hook | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/use-volume.json` |
| use-controls-visibility | registry:hook | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/use-controls-visibility.json` |
| use-track-events | registry:hook | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/use-track-events.json` |
| use-timeline | registry:hook | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/use-timeline.json` |
| use-player | registry:hook | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/use-player.json` |
| use-asset | registry:hook | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/use-asset.json` |
| use-playback-source | registry:hook | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/use-playback-source.json` |
| use-interval | registry:hook | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/use-interval.json` |
| use-captions | registry:hook | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/use-captions.json` |
| use-playback-rate | registry:hook | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/use-playback-rate.json` |
| use-seek | registry:hook | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/use-seek.json` |
| use-playlist | registry:hook | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/use-playlist.json` |
| use-playback | registry:hook | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/use-playback.json` |
| use-picture-in-picture | registry:hook | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/use-picture-in-picture.json` |
| use-idle | registry:hook | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/use-idle.json` |
| custom-demo-controls | registry:ui | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/custom-demo-controls.json` |
| internal-media | registry:lib | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/internal-media.json` |
| error-screen-demo | registry:example | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/error-screen-demo.json` |
| fallback-poster-demo | registry:example | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/fallback-poster-demo.json` |
| playback-state-control-demo | registry:example | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/playback-state-control-demo.json` |
| picture-in-picture-control-demo | registry:example | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/picture-in-picture-control-demo.json` |
| volume-slider-control-horizontal-demo | registry:example | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/volume-slider-control-horizontal-demo.json` |
| volume-slider-control-vertical-demo | registry:example | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/volume-slider-control-vertical-demo.json` |
| volume-state-control-demo | registry:example | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/volume-state-control-demo.json` |
| timeline-control-demo | registry:example | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/timeline-control-demo.json` |
| timeline-labels-demo | registry:example | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/timeline-labels-demo.json` |
| captions-state-control-demo | registry:example | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/captions-state-control-demo.json` |
| playback-rate-demo | registry:example | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/playback-rate-demo.json` |
| seek-control-demo | registry:example | — | `npx shadcn@latest add https://limeplay.winoffrg.dev/r/seek-control-demo.json` |

## For AI agents

```text
You are adding components from @limeplay to a shadcn-compatible project.
1. Read this file (https://sh4dcn.vercel.app/md/limeplay.md) for the component list.
2. Fetch the machine-readable index: https://limeplay.winoffrg.dev/r/registry.json
3. Install a single component with its install command from the table above.
4. Full structured record: https://sh4dcn.vercel.app/json (library slug: limeplay).
```