Skip to content

fix(captions): show the captions and the CC button in Safari - #385

Merged
antobinary merged 1 commit into
bigbluebutton:developfrom
germanocaumo:fix-safari-captions
Nov 18, 2026
Merged

antobinary merged 1 commit into
bigbluebutton:developfrom
germanocaumo:fix-safari-captions

Conversation

@germanocaumo

@germanocaumo germanocaumo commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

What does this PR do?

Shows the captions and the CC button in Safari.

video.js 7 only adds the tracks passed in its tracks option when it renders the captions itself (TextTrackDisplay skips them when the tech uses native text tracks). video.js uses native text tracks in Safari (and Chrome on iOS), so there the webcams player had no caption tracks and the CC button stayed hidden. Setting html5.nativeTextTracks: false lets video.js render the captions in every browser, as it already does in Chrome and Firefox.

The webcams video plays inline (playsInline) and the player has no native fullscreen toggle, so emulated captions don't lose anything to the iOS native fullscreen player.

Also part of #376, which bundles it with a redesign.

How to test

Open a recording with captions in Safari (or Playwright WebKit), turn the captions on and seek to a cue.

develop this PR
WebKit: CC button hidden visible
WebKit: caption tracks / cues none pt-BR, 1414 cues
WebKit: caption at 9 s — "E aí fica à vontade para começar a apresentação."
Chrome captions shown unchanged

WebKit, captions on, at 9 s (chat pixelated):

develop this PR
develop this PR

The caption spans the page width in every browser; that's the existing caption layout, unchanged here.

Checked with Playwright WebKit 26 on Linux, not on a real Safari or iOS device.

Changelog

  • Technical: the webcams player renders text tracks with video.js in every browser
  • User-facing: captions and the CC button show in Safari

video.js only adds the tracks passed in its options when it renders the
captions itself. Safari defaults to native text tracks, so it had no
caption tracks and the CC button stayed hidden. Let video.js render the
captions in every browser.
@antobinary
antobinary merged commit abd4bc9 into bigbluebutton:develop Nov 18, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants