PlaylistEmbed

PlaylistEmbed displays a video player with a scrollable playlist sidebar.

import { PlaylistEmbed } from "@seeen/embed/playlist";

<PlaylistEmbed
  videos={[
    { id: "1", title: "Episode 1", src: "https://example.com/ep1.m3u8", duration: 342 },
    { id: "2", title: "Episode 2", src: "https://example.com/ep2.m3u8", duration: 518 },
  ]}
/>

Props

Prop	Type	Required	Description
initialIndex	number	optional	Zero-based index of the video to play first. Defaults to `0`.
maxVideos	number	optional	Maximum number of videos to show. Applies to both modes; in API-driven mode, pagination stops once the limit is reached. Leave unset for no limit.
overlays	CtaOverlay[]	optional	CTA image overlays applied to every video in the playlist.
pageSize	number	optional	Number of videos to fetch per page in API-driven mode. Defaults to 30. Ignored in pre-fetched mode.

VideoItem

Prop	Type	Required	Description
aspectRatio	string	optional	Aspect ratio string from the API, e.g. `"16:9"` or `"9:16"`.
ctaTimestamps	CtaTimestamp[]	optional	Timestamped CTA banners that appear at specific points during playback.
description	string	optional	Optional description of the video content.
duration	number	optional	Duration in seconds. Used in playlist UI.
endCard	EndCard	optional	End card shown when playback finishes. Overrides `sponsor`.
id	string | number	required	Unique identifier for the video.
poster	string	optional	URL of the poster image shown before playback begins.
shareSocialMediaIcons	SocialMediaIcon[]	optional	Social share icons shown in the share popover.
sponsor	Sponsor	optional	Sponsor shown on the end card when no explicit `endCard` is provided.
src	string	required	URL of the video source. HLS (`.m3u8`) and MP4 are supported.
startTime	number	optional	Start playback at this position in seconds. Useful for moment clips.
thumbnailStoryboardUrl	string	optional	URL of a WebVTT thumbnail storyboard used for scrubber previews.
title	string	required	Display title of the video.