Summary

HLS.js v1.2.5 includes bug fixes and improvements over the last release.

Changes Since The Last Release

v1.2.4...v1.2.5

Bugfixes and Improvements

• ID3: add duration to metadata samples, mimic Safari behavior on unbounded cues (#4967) @jprjr
• Bugfix: Subtitles not working on live with EXT-X-PROGRAM-DATE-TIME gaps (#4999) @erankor
• Bugfix: Exception when xhr.response is null (#4980) @asashakira
• Bugfix: MPEG-2 TS segments not starting with TS packet sync byte (#5006) @robwalch
• Bugfix: MPEG-2 TS DTS/PTS overlap between segments #4976 (#4977) @robwalch
• Bugfix: HEVC 608 captions (#4972) @erankor
• Bugfix: Support Opus lowercase CODECS entry (#4526) @stolen
• Bugfix: Live stream not seeking to start position (#4951) @kmamal

Tasks

• Remove redundant discardEPB call & impl in tsdemuxer (#4983) @erankor
• Webpack 5 Upgrade (#5007) @robwalch

Documentation

• Added deprecated event descriptions to API.md and MIGRATING.md (#5009) @tailgo

Demo Page

https://hls-js-acf592b8-566a-4553-aa84-d2d6adcdc0db.netlify.app/

API and Breaking Changes

If you are upgrading from version v0.14.17 or lower, see the MIGRATING guide for API changes between v0.14.x and v1.0.0.

Feedback

Please provide feedback via Issues in GitHub. For more details on how to contribute to HLS.js, see our CONTRIBUTING guide.

Summary

HLS.js v1.2.4 includes bug fixes and improvements over the last release.

Changes Since The Last Release

v1.2.3...v1.2.4

• Patch for abandonRulesCheck sudden quality drops (#4917) @robwalch
• Disable 608 captions on levels with CLOSED-CAPTIONS=NONE (#4916) @robwalch
• Fixes for Dolby Vision level codecs and filtering of unknown codecs (#4907) @robwalch
• Fix broken loader link in table of contents (#4924) @littlespex
• Fix the sampling and channel spellings. (#4896) @kuroishi

Demo Page

https://hls-js-357e5663-c334-422c-88d9-fcfbf938b5dc.netlify.app/demo/

API and Breaking Changes

If you are upgrading from version v0.14.17 or lower, see the MIGRATING guide for API changes between v0.14.x and v1.0.0.

Feedback

Please provide feedback via Issues in GitHub. For more details on how to contribute to HLS.js, see our CONTRIBUTING guide.

Summary

HLS.js v1.2.3 includes bug fixes and improvements over the last release.

Changes Since The Last Release

v1.2.2...v1.2.3

• Bugfix: Caption missing after seeking back to start when stream is played from discontinuity break (#4889) @littlespex
• Bugfix: Load last VTT fragment in infinite loop (WebVTT with AES-128) (#4901) @mtoczko
• Bugfix: Initial timestamps must be unsigned for tfdt v1 box for Safari iPad OS 16/Ventura (#4900) @robwalch
• CI: Fix npm publishes not happening (#4892) @tjenkinson

Demo Page

https://hls-js-a7277301-16b6-4ae9-b56a-dbb2ae208a9c.netlify.app/demo/

API and Breaking Changes

If you are upgrading from version v0.14.17 or lower, see the MIGRATING guide for API changes between v0.14.x and v1.0.0.

Feedback

Please provide feedback via Issues in GitHub. For more details on how to contribute to HLS.js, see our CONTRIBUTING guide.

Summary

HLS.js v1.2.2 includes bug fixes and improvements over the last release.

Changes Since The Last Release

v1.2.1...v1.2.2

• Fix handling of negative composition timestamps (#4885) @robwalch
• Fix segment error handling with live streams (#4858) @robwalch
• Resume streaming after bitrate test with low max buffer (#4866) @robwalch
• Bugfix: segment loading order with gaps (#4864) @robwalch
  • Fix seek to live start regression in dev (#4887) @robwalch
• Fix subtitle buffered check (#4863) @robwalch
• bail if new tag does not directly follow previous version (#4855) @tjenkinson
• Update transmux state before decryption which can return early (#4857) @robwalch

Demo Page

https://hls-js-e9b6f668-5edb-4682-a6af-034455d028b1.netlify.app/

API and Breaking Changes

If you are upgrading from version v0.14.17 or lower, see the MIGRATING guide for API changes between v0.14.x and v1.0.0.

Feedback

Please provide feedback via Issues in GitHub. For more details on how to contribute to HLS.js, see our CONTRIBUTING guide.

Summary

HLS.js v1.2.1 includes bug fixes and improvements over the last release.

Changes Since The Last Release

v1.2.0...v1.2.1

• Determine text track kind based on CHARACTERISTICS (#4850) @lpommers
• Add WebVTT EXT-X-MAP support (#4839) @robwalch
• Forward worker logs to main thread logs (#4820) @lpommers
• Fix audio demuxer contiguity with segments not carrying ID3 timestamps (#4847) @robwalch
• Fix sidx duration (#4849) @nklhtv
• Fix attach/detach and recoverMediaError resume with alt audio (#4816) @robwalch
• Cleanup stream controller logger statements (#4838) @robwalch
• Docs: Update Loader Composition code example with code that does not produce runtime errors (#4845) @littlespex
• CI: switch to W3C WebDriver protocol (#4834) @tjenkinson
• CI: Fix safari on sauce labs: lock selenium-webdriver to 4.1.0 for now (#4827) @tjenkinson
• CI: Update workflows to use Node.js v16 (#4821) @robwalch

Demo Page

https://hls-js-c682795c-032a-4c39-9374-225b776c04f6.netlify.app/

API and Breaking Changes

If you are upgrading from version v0.14.17 or lower, see the MIGRATING guide for API changes between v0.14.x and v1.0.0.

Feedback

Please provide feedback via Issues in GitHub. For more details on how to contribute to HLS.js, see our CONTRIBUTING guide.

Summary

HLS.js v1.2.0 adds enhanced interoperability and accessibility via improved support for various timed metadata, captions, and subtitle formats, along with bug fixes and improvements.

Changes Since The Last Release

v1.1.5...v1.2.0

• Throttle audio stream controller based on main buffer state (#4809) @robwalch
• Make gap controller wait for active fragments while seeking (#4806) @robwalch
• Update functional test targets (#4812) @robwalch
• Bugfix: Use audio PTS over playlist time when aligned with video (#4808) @robwalch
• Simplify backtracking logic to handle segments without keyframes (#4807) @robwalch
• Remove Internet Explorer 11 support (#4802) @robwalch
  v1.2.0-beta.1...v1.2.0-beta.2
• Paused-but-seeking video buffer hole gap jump support (#4667) @karendolan
• Fix loop loading of segments caused by backtracking logic (#4801) @robwalch
• Fix stalls in streams with segments that have no media (#4800) @robwalch
• Bugfix: Handle single sample MPEG2-TS video segments (#4794) @robwalch
• Bugfix: Slow start on stream with CAN-BLOCK-RELOAD=YES (#4793) @robwalch
• Bugfix: Include NAL filler data in AVC samples (#4789) @robwalch
• Guard against exceptions caused by destroying player in buffer stall error callbacks (#4786) @robwalch
• Bugfix: hls.subtitleDisplay doesn't toggle visibility until track selection (#4785) @robwalch
• Fix typos in design doc (#4790) @saikatmitra91
  v1.1.5...v1.2.0-beta.1
• Add Support for EXT-X-DATERANGE enhanced parsing and metadata TextTrack Cues (#4720) @robwalch
• Add support for emsg ID3 metadata in fmp4 segments (#4458) @robwalch
• Config options to disable metadata TextTrack Cue processing (#4782) @robwalch
• Add support for CMAF SEI Captions (#4459) @robwalch (Thanks to @gkolb for #2623 and @ioppermann for #4242)
• Add ignoreDevicePixelRatio configuration option (#3765) @i8beef
• Add alternate HEVC box to fallback codec string. (#4734) @itsjamie
• Do not allow cues with negative startTimes to be added to the text track (#4757) @littlespex
• Update ID3 cues to span until playlist end, or next cue with same tag type (value.key) on cue append (#4719) @robwalch
• Include Panasonic Smart TVs and other old browsers in positive DTS gate (#4780) @jeremies
• Allow exact bitrate matches for minAutoLevel getter (#4629) @littlespex
• Fix nudge retries happening one time fewer than nudgeRetry config (#4485) @tjenkinson
• Bugfix: Store track info when buffer codec switched (#4308) @albertdaurell
• Fix handling encrypted AAC frames when there's no encrypted data in a frame (#4514) @loganek
• Fix AAC overflow when it occurs at ADTS header (#4781) @robwalch
• Fix sidx parsing (#4334) @nklhtv
• Fix: level playlist parse error of ProgramDateTime (#4498) @hongfeih-es
• Bugfix: Incorrect manifest parsing around init segments (#4237) @hongfeih-es
• Bugfix: Low-Latency HLS endofstream (#4516) @cjpillsbury
• Bugfix: IAvoid _appendCues exception (#4552) @albertdaurell
• Bugfix: freeze after buffer full error occur (#4686) @hongfeih-es
• Bugfix: Network hangs on streaming level switch using fetch loader (#4729) @robwalch
• Fix exception in fetch-loader error handler (#3929) @softworkz
• Bugfix: Failed to execute 'update' on 'MediaKeySession (#4577) @hongfeih-es
• Bugfix: Segmented VTT captions cease downloading on live time shifted streams (#4688) @littlespex
• Retry aligning audio playlist with main playlist if levelloaded came too early (#4600) @Frenzie
• Fix: don't re-write baseMediaDecodeTime in tfdt v0 to a negative value (#4670) @jwbrandon
• Prevent base stream from logging after stop (#4564) @wehriam
• Bugfix: forwardBufferLength calculation (#4608) @hongfeih-es
• Bugfix/webvtt-parse: cue offset (subtitle stream without X-TIMESTAMP-MAP) (#4557) @mtoczko
• Bugfix: IMSC1 parsing error (#4218) @mtoczko
• Refactor: replace deprecated String.prototype.substr() (#4605) @CommanderRoot
• Prepare for supporting more audio codecs (#3930) @softworkz
• Resolve linting issue causing build to fail. (#4604) @itsjamie
• Fix esllnt not running on precommit (#4593) @tjenkinson
• Update jsdelivr urls in readme to point at canary and v1 (#4715) @tjenkinson
• Update documentation on testBandwidth. (#4641) @itsjamie
• Fix: typos (#4603) @FredZeng
• chore: replace png logo with svg (#4601) @jungdaniel
• Add Brid.tv as a player solution that utilizes hls.js in README.md. (#4597) @Sovica

Demo Page

https://hls-js-bbdf933d-da48-407d-aaf3-68cc4ee058e7.netlify.app/demo/

API and Breaking Changes

If you are upgrading from version v0.14.17 or lower, see the MIGRATING guide for API changes between v0.14.x and v1.0.0.

Feedback

Please provide feedback via Issues in GitHub. For more details on how to contribute to HLS.js, see our CONTRIBUTING guide.

Summary

HLS.js v1.2.0-beta.2 includes bug fixes and improvements over the last release.

Changes Since The Last Release

v1.2.0-beta.1...v1.2.0-beta.2

• Paused-but-seeking video buffer hole gap jump support (#4667) @karendolan
• Fix loop loading of segments caused by backtracking logic (#4801) @robwalch
• Fix stalls in streams with segments that have no media (#4800) @robwalch
• Bugfix: Handle single sample MPEG2-TS video segments (#4794) @robwalch
• Bugfix: Slow start on stream with CAN-BLOCK-RELOAD=YES (#4793) @robwalch
• Bugfix: Include NAL filler data in AVC samples (#4789) @robwalch
• Guard against exceptions caused by destroying player in buffer stall error callbacks (#4786) @robwalch
• Bugfix: hls.subtitleDisplay doesn't toggle visibility until track selection (#4785) @robwalch
• Fix typos in design doc (#4790) @saikatmitra91

Demo Page

https://hls-js-b6cc3ed7-a51c-46de-9812-73e071127353.netlify.app/demo/

API and Breaking Changes

If you are upgrading from version v0.14.17 or lower, see the MIGRATING guide for API changes between v0.14.x and v1.0.0.

Feedback

Please provide feedback via Issues in GitHub. For more details on how to contribute to HLS.js, see our CONTRIBUTING guide.

Summary

HLS.js v1.2.0-beta.1 is a pre-release of v1.2.0. This release adds enhanced interoperability and accessibility via improved support for various timed metadata, captions, and subtitle formats, along with bug fixes and improvements.

Changes Since The Last Release

v1.1.5...v1.2.0-beta.1

• Add Support for EXT-X-DATERANGE enhanced parsing and metadata TextTrack Cues (#4720) @robwalch
• Add support for emsg ID3 metadata in fmp4 segments (#4458) @robwalch
• Config options to disable metadata TextTrack Cue processing (#4782) @robwalch
• Add support for CMAF SEI Captions (#4459) @robwalch (Thanks to @gkolb for #2623 and @ioppermann for #4242)
• Add ignoreDevicePixelRatio configuration option (#3765) @i8beef
• Add alternate HEVC box to fallback codec string. (#4734) @itsjamie
• Do not allow cues with negative startTimes to be added to the text track (#4757) @littlespex
• Update ID3 cues to span until playlist end, or next cue with same tag type (value.key) on cue append (#4719) @robwalch
• Include Panasonic Smart TVs and other old browsers in positive DTS gate (#4780) @jeremies
• Allow exact bitrate matches for minAutoLevel getter (#4629) @littlespex
• Fix nudge retries happening one time fewer than nudgeRetry config (#4485) @tjenkinson
• Bugfix: Store track info when buffer codec switched (#4308) @albertdaurell
• Fix handling encrypted AAC frames when there's no encrypted data in a frame (#4514) @loganek
• Fix AAC overflow when it occurs at ADTS header (#4781) @robwalch
• Fix sidx parsing (#4334) @nklhtv
• Fix: level playlist parse error of ProgramDateTime (#4498) @hongfeih-es
• Bugfix: Incorrect manifest parsing around init segments (#4237) @hongfeih-es
• Bugfix: Low-Latency HLS endofstream (#4516) @cjpillsbury
• Bugfix: IAvoid _appendCues exception (#4552) @albertdaurell
• Bugfix: freeze after buffer full error occur (#4686) @hongfeih-es
• Bugfix: Network hangs on streaming level switch using fetch loader (#4729) @robwalch
• Fix exception in fetch-loader error handler (#3929) @softworkz
• Bugfix: Failed to execute 'update' on 'MediaKeySession (#4577) @hongfeih-es
• Bugfix: Segmented VTT captions cease downloading on live time shifted streams (#4688) @littlespex
• Retry aligning audio playlist with main playlist if levelloaded came too early (#4600) @Frenzie
• Fix: don't re-write baseMediaDecodeTime in tfdt v0 to a negative value (#4670) @jwbrandon
• Prevent base stream from logging after stop (#4564) @wehriam
• Bugfix: forwardBufferLength calculation (#4608) @hongfeih-es
• Bugfix/webvtt-parse: cue offset (subtitle stream without X-TIMESTAMP-MAP) (#4557) @mtoczko
• Bugfix: IMSC1 parsing error (#4218) @mtoczko
• Refactor: replace deprecated String.prototype.substr() (#4605) @CommanderRoot
• Prepare for supporting more audio codecs (#3930) @softworkz
• Resolve linting issue causing build to fail. (#4604) @itsjamie
• Fix esllnt not running on precommit (#4593) @tjenkinson
• Update jsdelivr urls in readme to point at canary and v1 (#4715) @tjenkinson
• Update documentation on testBandwidth. (#4641) @itsjamie
• Fix: typos (#4603) @FredZeng
• chore: replace png logo with svg (#4601) @jungdaniel
• Add Brid.tv as a player solution that utilizes hls.js in README.md. (#4597) @Sovica

Demo Page

https://hls-js-35b3c8f7-2907-42de-bc7a-4fde8f228842.netlify.app/demo/

API and Breaking Changes

If you are upgrading from version v0.14.17 or lower, see the MIGRATING guide for API changes between v0.14.x and v1.0.0.

Feedback

Please provide feedback via Issues in GitHub. For more details on how to contribute to HLS.js, see our CONTRIBUTING guide.

Summary

HLS.js v1.1.5 includes bug fixes and improvements over the last release.

Changes Since The Last Release

v1.1.4...v1.1.5

• Fixes a bug with ll-hls where ended events would not fire under certain conditions.

Demo Page

https://hls-js-eb7b4375-60e8-4617-93ce-d0d9ef584df1.netlify.app/

API and Breaking Changes

If you are upgrading from version v0.14.17 or lower, see the MIGRATING guide for API changes between v0.14.x and v1.0.0.

Feedback

Please provide feedback via Issues in GitHub. For more details on how to contribute to HLS.js, see our CONTRIBUTING guide.

Summary

HLS.js v1.1.4 includes bug fixes and improvements over the last release.

Changes Since The Last Release

v1.1.3...v1.1.4

• Bugfix: Encrypted VTT subtitles not rendered (#4554) @mtoczko
  • Fixes #4182 #4293

Demo Page

https://hls-js-42cf332b-b861-4821-9db0-81644f465908.netlify.app/demo/

API and Breaking Changes

If you are upgrading from version v0.14.17 or lower, see the MIGRATING guide for API changes between v0.14.x and v1.0.0.

Feedback

Please provide feedback via Issues in GitHub. For more details on how to contribute to HLS.js, see our CONTRIBUTING guide.