Embed-ready movie and TV player

VidPulse

Build a movie or TV embed URL, preview it live, then copy the exact snippet you can drop into an iframe. The player stays configurable, provider-aware, and focused on the actual embed flow.

View API docs

Direct routes

/embed/movie/:tmdbId

TV support

/embed/tv/:tmdbId/:season/:episode

Host events

PLAYER_EVENT postMessage

Provider-aware playback

The embed player can probe providers while loading, switch to a working source, and still keep provider selection inside the player.

URL-driven branding

Color, autoplay, episode navigation, and provider defaults are controlled through simple embed parameters.

Parent window events

Track playback state from the host page through postMessage events without needing a custom SDK.

Streaming-first player

Built for fullscreen embed usage with progress restore, subtitles, HLS playback, and provider-based quality selection.

Embed Builder

Configure a real player URL, preview it live, and copy exactly what you need for another site.

Live Preview

Direct embed route with in-player configuration.

Open full player

Movie route#0dcaf0Default behavior

Route

Choose the content type and identifiers.

TMDB IDDefault providerStart at second

Player options

Adjust branding and playback behavior.

Hex color

Generated output

Copy the URL or the full iframe snippet.

<iframe
  src=""
  width="100%"
  height="600"
  allow="autoplay; fullscreen"
  allowfullscreen
></iframe>

Integration Reference

The homepage is meant to get you to a working embed fast. These are the route shapes, parameters, and parent-page hooks behind it.

Single iframe

Use the generated URL directly or copy a ready-to-paste iframe snippet.

Embed-first routes

Movie and TV embeds are direct player pages, not nested wrappers.

Progress-aware

Playback progress and preferences can persist cleanly across embed sessions.

Host integration

PostMessage events make it easy to sync analytics, progress, or custom UI.

Embed routes

Movie

/embed/movie/{tmdbId}

Use a TMDB movie id.

/embed/tv/{tmdbId}/{season}/{episode}

Use a TMDB show id plus season and episode.

Watch progress events

Listen for player events on the host page to sync progress or UI.

Events

timeupdate
play
pause
ended
seeked

Payload shape

URL parameters

Parameter	Type	Description	Example
`color`	string	Primary color in hex without the #	`?color=e50914`
`autoPlay`	boolean	Start playback automatically	`?autoPlay=true`
`nextEpisode`	boolean	Enable next-episode behavior for TV routes	`?nextEpisode=true`
`episodeSelector`	boolean	Show the episode browser in the player	`?episodeSelector=true`
`progress`	number	Start from a specific second	`?progress=120`
`provider`	string	Choose the initial provider id	`?provider=vidify`

A plain movie player with default styling.

FAQ

Short answers for the things you usually need first.

Can I use the player as a plain iframe embed?

Yes. The home page generates the direct embed URL and a full iframe snippet you can paste into any page immediately.

Can I choose a default provider?

Yes. Use the provider query parameter to preload a preferred provider while still keeping provider switching inside the player.

How do I track playback from the parent page?

Listen for PLAYER_EVENT messages on window and read current time, duration, progress, media id, and TV episode context from the payload.