Player integration guide

Online player

Open this player from another website or app using a video URL. Optional parameters configure playback.

Use #url= for playback links. Put the video URL and all playback options after #.

Create a playback link

URL
https://m3u8-player.com/#url=https://example.com/video.m3u8
JavaScript
const videoUrl = 'https://example.com/video.m3u8';
const params = new URLSearchParams({
  url: videoUrl, autoplay: '1', muted: '1'
});
const playerUrl = 'https://m3u8-player.com/#' + params;
window.open(playerUrl, '_blank', 'noopener');

Encode the complete video URL once as the url value. Separate options with &. Use encodeURIComponent or URLSearchParams to build the link.

Playback link parameters

ParameterValuesDefaultDescription
urlHTTPS URLRequiredVideo URL
title≤ 120autoVideo name
typeauto / hls / videoautoFormat
autoplay0 / 11Autoplay
muted0 / 10Mute
volume0–1Local settingVolume
rate0.25–4Local settingPlayback speed
start90 / 01:30 / 00:01:30Saved progressStart position (on-demand)
loop0 / 1Local settingLoop
posterHTTPS URL—Poster image
subtitleHTTPS SRT / VTT URL—Subtitles
langar / de / en / es / fr / hi / id / it / ja / ko / pt / ru / th / tr / vi / zh-CN / zh-TWautoChange language
history0 / 1Local settingHistory
resume0 / 11Saved progress
theater0 / 10Theater
lights0 / 10Lights off
qualityauto / 720 / 1080 / …autoQuality
audio0 / 1 / …autoAudio
aspectauto / 16:9 / 4:3 / 1:1autoAspect ratio

Usage notes

  • autoplay=0 loads the player paused. muted=1 can help autoplay; the browser may still require a click. Fullscreen and picture-in-picture need a user action.
  • Options affect this playback only. Omitted values follow local settings. history=0 skips recording; history=1 respects the local history switch. start overrides saved progress; resume=0 disables it.
  • Quality and audio options depend on the video source and browser. start applies to on-demand videos; audio tracks are numbered from 0.
  • Remote subtitles support UTF-8 SRT and VTT files up to 5 MiB. The subtitle URL must allow cross-origin access.