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

Supported Formats

Dubby can play virtually any media format. Files that aren’t natively supported by your device are automatically transcoded.

CodecWebApple TVAndroid TVShield Pro
H.264 (AVC)DirectDirectDirectDirect
H.265 (HEVC)TranscodeDirectDirectDirect
VP9DirectTranscodeDirectDirect
AV1DirectTranscodeTranscodeTranscode

When transcoding is needed, the server converts to H.264 (broadest compatibility) using hardware acceleration if available.

CodecWebApple TVAndroid TVShield Pro
AACDirectDirectDirectDirect
AC3 (Dolby Digital)TranscodeDirectPassthroughPassthrough
EAC3 (DD+)TranscodeDirectPassthroughPassthrough
DTSTranscodeTranscodePassthroughPassthrough
TrueHDTranscodeTranscodeTranscodePassthrough
OpusDirectTranscodeDirectDirect
FLACDirectDirectDirectDirect
MP3DirectDirectDirectDirect

Default transcode targets by platform:

  • Web — AAC stereo (browsers don’t support surround via MSE)
  • Apple TV — AC3 5.1
  • Android TV — AC3 5.1 (AAC via HDMI passthrough causes silence)
  • Shield Pro — EAC3 (supports Atmos; lossless formats passthrough natively)

Audio bitrate defaults: 384 kbps for 5.1+, 192 kbps for stereo.

For direct play (HTTP Range):

ContainerWebApple TVAndroid TVShield Pro
MP4 / M4V / MOVDirectDirectHLSDirect
MKVHLSHLSHLSDirect
WebMDirectHLSHLSDirect
AVIHLSHLSHLSHLS

Files in unsupported containers are remuxed (repackaged without re-encoding) into HLS, which adds minimal overhead.

FormatWebApple TVAndroid TVShield Pro
HDR10Not supportedPassthroughPassthroughPassthrough
HLGNot supportedPassthroughPassthroughPassthrough
Dolby Vision P5Not supportedPassthroughHDR10 fallbackNative decode
Dolby Vision P7/P8Not supportedHDR10 fallbackHDR10 fallbackNative decode

When a device doesn’t support the source HDR format, the server tonemaps to SDR automatically.

FormatTypeSupport
SRTTextExtracted and delivered as WebVTT
ASS / SSATextConverted to WebVTT (styling simplified)
WebVTTTextNative support
PGS / SUPImage-basedBurned into video (requires full transcode)
  • External subtitles (files next to the video) are auto-detected during library scan
  • Embedded subtitles (inside the container) are extracted and delivered separately
  • Image-based subtitles (PGS) must be burned into the video stream, which triggers a full transcode
Source formatWebApple TVAndroid TVShield Pro
H.264 + AAC (MP4)DirectDirectHLSDirect
HEVC + AAC (MKV)TranscodeHLSHLSDirect
H.264 + AC3 (MKV)Transcode audioHLSHLSDirect
HEVC + TrueHD (MKV)Full transcodeTranscode audioTranscode audioDirect
HEVC + HDR10Transcode to SDRPassthroughPassthroughPassthrough
HEVC + Dolby VisionTranscode to SDRPassthrough (P5)HDR10 fallbackNative DV