Skip to content
🚧 These docs are a work in progress and may contain inaccuracies. Content is being actively reviewed and validated.

Web Client

The web client runs in any modern browser and provides the full Dubby experience — browsing, playback, and administration.

BrowserMinimum versionNotes
Chrome90+Best compatibility
Firefox90+Full support
Safari15+No HEVC via HLS.js (transcoded to H.264)
Edge90+Chromium-based, same as Chrome

All browsers use hls.js for HLS playback via MediaSource Extensions (MSE).

CodecSupport
H.264Direct play
HEVC (H.265)Transcoded to H.264 (browsers can’t decode HEVC via MSE)
VP9Direct play
AV1Direct play (Chrome 70+, Firefox 67+)
AACDirect play
AC3 / EAC3Transcoded to AAC
DTS / TrueHDTranscoded to AAC
Opus / FLACDirect play

Audio is limited to stereo in browsers — surround sound formats are downmixed to 2-channel AAC.

  • Seek preview — Hover over the seek bar to see trickplay thumbnails
  • Skip intro — Overlay button when intro segments are detected
  • Subtitle overlay — Text subtitles rendered as a custom overlay
  • Continue watching — Resume from where you left off across devices
KeyAction
Space / KPlay / Pause
FToggle fullscreen
MToggle mute
Left arrowSeek back 10 seconds
Right arrowSeek forward 10 seconds
Up arrowVolume up
Down arrowVolume down

The web client can direct play (zero transcoding) when all of these are true:

  • Video codec is H.264, VP9, or AV1
  • Audio codec is AAC, Opus, or FLAC
  • Container is MP4 or WebM
  • No subtitle burn-in required

For all other combinations, the server transcodes and delivers via HLS.

  • No HEVC — Browsers don’t support HEVC via MediaSource Extensions, even on macOS where the OS decoder is available
  • Stereo only — MSE doesn’t support multichannel audio output
  • No HDR — Web browsers don’t support HDR video rendering