Entronn Video Player Documentation

Covers Entronn Video Player v1.0.1+. For the full list of shortcode attributes and URL parameters, see the Shortcode Reference.

Overview

Entronn Video Player replaces the default WordPress video player with a self-hosted HLS/MP4 player. It handles adaptive streaming, subtitles, playback resume, ad insertion, and optional signed-URL protection — all configured from the WordPress admin, without any external API keys to set up.

Installation & Activation

Install Entronn Video Player from the WordPress Plugin Directory, or upload the plugin ZIP under Plugins → Add New → Upload Plugin. Activate it like any other plugin.

• No API keys, license keys, or config files are required to start playing HLS or MP4 video.
• Existing <video> tags in your posts are detected automatically and upgraded to the Entronn player on render — no content changes needed.
• Pro and Business features (signed URLs, VAST ads, analytics) unlock automatically once a license is activated under Settings → Entronn Player.

Adding Your First Video

There are two ways to add a player to a post or page: the shortcode, or the Gutenberg block.

The shortcode is the fastest way to drop a player anywhere shortcodes are supported, including widgets and page builders:

[entronn_player src="https://example.com/video/master.m3u8"]

See the full attribute reference for poster images, subtitles, autoplay, ads, and more.

Using the Gutenberg Block

In the block editor, search for “Entronn Video Player” and insert it like any other block. The block's sidebar exposes the same options as the shortcode — video source, poster, subtitles, autoplay, and accent color — through form fields instead of shortcode attributes, so you don't need to remember attribute names.

Switching a block back to classic mode or copying it into another editor converts it to the equivalent [entronn_player] shortcode automatically.

Subtitles & Captions

Point the subtitle attribute (or the block's Subtitle field) at a WebVTT (.vtt) file. Multiple subtitle tracks and language labels can be configured from the block sidebar; shortcode users can add additional tracks with repeated subtitle attributes.

Ad Insertion

Configure pre-roll, mid-roll, and post-roll ads per video, either as a direct ad video URL or as a VAST tag (Pro and above). For each ad you can set:

• A skip countdown, in seconds, before the skip button appears.
• Whether the ad is non-skippable.
• An optional sponsor button with a custom label and link.
• Timed mid-roll insertion points, specified as playback timestamps.

VAST-compatible ad servers and networks are supported directly — the player reads the tag, so no custom integration work is required.

Theming & Accent Colors

Set a default accent color and play-button gradient from Settings → Entronn Player → Appearance. Need a different look for one specific embed? Override the colors per-embed without touching global settings — see URL Parameters for the exact query parameters.

Signed URLs & Content Protection Pro

On the Pro plan and above, HLS playlists are rewritten so each video segment and audio track is served through an HMAC-SHA256 signed URL that expires two hours after it's issued. A domain whitelist (checked via the Referer header) restricts which sites the player is allowed to load on, and the signing endpoint itself requires a short-lived token — calling it directly returns a 403.

Analytics Business

On the Business plan, the WordPress dashboard shows plays, watch time, completion rate, and viewer drop-off per video, along with ad impressions and click-through for any configured ads.

Troubleshooting & FAQ

My HLS stream won't switch quality levels. Confirm your master.m3u8 actually lists multiple quality variants — the player only switches between levels that exist in the playlist. A single-variant playlist will play, but there's nothing to switch to.

Playback position isn't resuming. Resume position is stored in the visitor's browser via localStorage, scoped per video URL. Clearing site data, private browsing, or changing the video's URL will reset it.

Signed URLs return a 403. Signed links expire two hours after they're issued and are tied to the domain whitelist — check that the requesting domain is approved under Settings → Entronn Player → Security, and that the link hasn't simply expired.

Didn't find what you're looking for? Reach out through the support channel linked in the footer below.