Apple TV
The Apple TV client is a native tvOS application built with React Native. It supports Apple TV 4K with full HDR passthrough and D-pad remote navigation.
Supported hardware
Section titled “Supported hardware”| Device | Minimum tvOS | Notes |
|---|---|---|
| Apple TV 4K | tvOS 16+ | Full support including HDR |
| Apple TV HD | tvOS 16+ | No HDR (hardware limitation) |
Codec support
Section titled “Codec support”| Capability | Details |
|---|---|
| Video | HEVC, H.264 |
| Audio | AAC, AC3, EAC3, FLAC — up to 7.1 channels |
| Max resolution | 4K |
| HDR | HDR10, HLG, Dolby Vision P5 |
| Transport | HTTP Range for MP4/MOV; HLS for everything else |
| Direct play | MP4/MOV/M4V containers |
Apple TV uses fMP4 segments for HEVC content (MPEG-TS causes silent video). DTS and TrueHD audio are transcoded to AC3.
Navigation
Section titled “Navigation”The app is designed for the Siri Remote and D-pad navigation:
| Button | Action |
|---|---|
| D-pad / swipe | Navigate between items |
| Select | Confirm selection, play |
| Menu | Go back, close overlay |
| Play/Pause | Toggle playback |
Playback features
Section titled “Playback features”- Skip intro — Overlay button when intro segments are detected
- Seek preview — Trickplay thumbnails while scrubbing
- Audio/subtitle switching — Change tracks during playback
- Continue watching — Resume across devices
- HDR passthrough — HDR10, HLG, and Dolby Vision Profile 5 content plays in native HDR
Device detection
Section titled “Device detection”The app identifies itself to the server via the X-Dubby-Client header:
DubbyTV/1.0 (tvOS; ios; <systemVersion>; <modelName>)The server applies the Apple TV device profile automatically based on this header.