Installation 

Requirements 

• PHP 8.2+
• TYPO3 13.4 or 14
• b13/poster-image 2.x
• ffmpeg and ffprobe on the host that runs the worker

Setup 

1. Install ffmpeg and ffprobe on the host that runs the worker.
2. Add the site set Adaptive Video (mfd/adaptive-video) to the sites that should deliver streams.
3. Enable processing in exactly the environments that encode (see Configuration), schedule the scan and run the worker (see Usage).
4. Configure the web server and allow blob: in your Content Security Policy, see below.

Web server and CDN 

The artifact directory is served as static files. Make sure that

• .m3u8 is delivered as application/vnd.apple.mpegurl and .m4s as video/iso.segment (or video/mp4), e.g. for Apache:

  AddType application/vnd.apple.mpegurl .m3u8
  AddType video/iso.segment .m4s

  Copied!
• the files may be cached for a long time: every version has its own directory, so the content behind a URL never changes.
• streams are served from the same host as the page. Otherwise the host has to be allowed in the CSP and send CORS headers.

Content Security Policy 

The extension does not change the CSP. hls.js needs blob: for the media source and its web worker:

media-src 'self' blob:;
worker-src 'self' blob:;

Without it, streams do not play in browsers without native HLS (Chrome, Firefox, Edge). Check the browser console for CSP violations when testing.