{ "schemaVersion": 2, "product": "BOSS Player SDK", "featureCount": 43, "statusDefinitions": { "completed": "Implemented for the stated scope. Odyssey-used features are considered completed at their working integration scope; this does not imply universal device, source or external-output certification." }, "catalogueNotes": [ "Implemented capabilities only; unavailable roadmap requirements are omitted.", "Completed applies to the described playback or SDK implementation, not every possible device, backend or source.", "Dolby Vision P5, P7 MEL, P7 FEL and P8 are explicitly covered; no claim is made for unlisted profiles.", "This is a full SDK capability catalogue, not a GPL edition entitlement list.", "F09 and F23 retain the same recording implementation under their historical catalogue IDs." ], "features": [ { "id": "P01", "title": "Video upscaling / resolution enhancement", "category": "Video processing", "status": "completed", "scope": "Optional BOSS directional upscaling is implemented and enabled in Odyssey for eligible progressive SDR video. Automatic and directional modes use the BOSS reconstruction path, with bounded GPU resources and display-aware output sizing.", "limits": "Source, geometry and device limits apply. HDR, Dolby Vision and interlaced pictures retain their appropriate playback path. MetalFX is a separate explicit option, not the accepted default.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain.", "completionBasis": "Odyssey use and owner acceptance; current SDK implementation inspected." }, { "id": "P02", "title": "Scrub thumbnails", "category": "Playback controls", "status": "completed", "scope": "Bounded thumbnail previews follow the touch or TV seek cursor on supported native and owned playback routes.", "limits": "Coverage and latency vary by source and backend; live previews are limited to available history.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "P03", "title": "Matroska on Apple playback surfaces", "category": "Formats", "status": "completed", "scope": "Compatible MKV sources use owned decoding to Apple sample-buffer output or a container bridge to AVPlayer.", "limits": "These are distinct routes. Not every MKV codec, track layout or Dolby variant uses AVPlayer directly.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "P04", "title": "Height-speaker channel mapping", "category": "Audio", "status": "completed", "scope": "Explicit height-channel labels are converted to CoreAudio channel labels on eligible decoded PCM paths.", "limits": "Negotiated output routing and actual height-speaker playback remain unverified. Channel labels do not establish object-audio or Atmos output.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "P06", "title": "Persistent media cache", "category": "Networking and storage", "status": "completed", "scope": "Finite HTTP range caching and finite HLS resource staging support bounded storage, identity checks and offline reopening of supported sources.", "limits": "DRM graphs, arbitrary live persistence and all provider configurations are not covered. Host integration controls cache policy.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "P08", "title": "Prewarmed switching", "category": "Playback controls", "status": "completed", "scope": "Native MP4/MOV/M4V/HLS and owned-source preparation support preloading the next video while the current source remains active. Odyssey integrates prepared next-episode handoff and starts automatic Play Next at 0:00.", "limits": "Preparation eligibility and transition latency depend on source, backend, processing and host lifecycle. No universal zero-delay guarantee.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain.", "completionBasis": "Odyssey prepared next-episode handoff and current SDK implementation." }, { "id": "P10", "title": "Live rewind and pause buffer", "category": "Live TV", "status": "completed", "scope": "An app-owned rolling buffer for supported raw TS sources provides bounded pause, rewind and return toward the live edge.", "limits": "Rewind is limited to retained data. Provider HLS windows, long pauses, discontinuities and recovery have route-specific limits.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "P11", "title": "Offline speech-to-subtitle generation", "category": "AI and accessibility", "status": "completed", "scope": "Local speech models generate timed subtitles from supported audio, with audio decoding/resampling, subtitle output, track selection and cancellation integrated in the SDK.", "limits": "The host must provision a compatible local model. Supported media, model languages, transcription accuracy and sustained performance vary; this is not an always-on live caption guarantee.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "P12", "title": "Dolby Vision P5, P7 MEL, P7 FEL and P8", "category": "HDR and Dolby", "status": "completed", "scope": "Dolby Vision playback paths are implemented and used in Odyssey: Profile 5, Profile 7 MEL, Profile 7 FEL enhancement-layer reconstruction and Profile 8. Source identity, RPU metadata and explicit adaptation policy are preserved as separate concepts. The current Odyssey bridge includes the FEL-to-Dolby policy.", "limits": "Completed denotes the working Odyssey playback implementation, including FEL support. Profile variants, source structure, selected adaptation, OS, device and display route determine output. P7 MEL-to-P8.1 adaptation is explicit. This is not blanket Dolby/HDMI certification, and unlisted profiles are not claimed.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain.", "completionBasis": "Odyssey use and owner acceptance, recorded device FEL playback and current Odyssey Dolby policy bridge." }, { "id": "P13", "title": "Separate audio and video inputs", "category": "Playback controls", "status": "completed", "scope": "Independent finite audio and video sources can share the playback clock with coordinated startup, seek and shutdown.", "limits": "Live sources, arbitrary provider combinations and all loop modes are not covered.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "P14", "title": "Unencrypted Blu-ray title playback", "category": "Formats", "status": "completed", "scope": "Local and authorized network Blu-ray title reading, title/chapter selection and title streaming are implemented in the SDK.", "limits": "Unencrypted supported Blu-ray structures only. Full disc menus, BD-J, decryption and DVD playback are not part of this feature.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "P15", "title": "Resumable mini-player", "category": "Presentation", "status": "completed", "scope": "Supported native and owned sessions can retain their playback owner and surface while moving between expanded and compact presentation.", "limits": "Host navigation integration is required; FEL and compatibility-route coverage is not universal.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F02", "title": "Swift Concurrency", "category": "Integration", "status": "completed", "scope": "MainActor-isolated player control, asynchronous loading, cancellation and source-generation guards underpin the SDK.", "limits": "Application integration must respect ownership and cancellation contracts; this is not a claim of architectural equivalence to another SDK.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F03", "title": "GPU deinterlacing", "category": "Video processing", "status": "completed", "scope": "Supported interlaced sources can use a bounded Metal spatial bob deinterlacer.", "limits": "Dedicated VideoToolbox deinterlacing is not claimed. Cadence, quality and codec coverage depend on valid field metadata and the playback route.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F04", "title": "AV1 playback", "category": "Formats", "status": "completed", "scope": "AV1 playback is implemented on supported decode paths, using hardware acceleration where the device and backend provide it.", "limits": "Codec profile and device limits apply. AV1 playback does not imply hardware decoding on every Apple device.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F05", "title": "Word-timed subtitles", "category": "Subtitles", "status": "completed", "scope": "Authored WebVTT inline timings and ASS karaoke can drive word-specific subtitle presentation.", "limits": "Plain captions do not acquire invented word timings. Full WebVTT region and CSS behavior is not covered.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F06", "title": "HDR10+ dynamic metadata handling", "category": "HDR and Dolby", "status": "completed", "scope": "Authored per-frame HDR10+ metadata is bounded, syntax-validated and attached to eligible Apple sample buffers.", "limits": "Attachment does not prove display consumption or dynamic tone-mapping conformance. Device, renderer and sink validation remain separate. November 4 validation control: the exact upstream fixture encodes target luminance 5000000/1 and is rejected by the BOSS range check. A separate 500/1 control attaches metadata and renders both frames. Detection does not prove display consumption.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F07", "title": "Subtitle translation", "category": "AI and accessibility", "status": "completed", "scope": "Translation providers can convert timed text while retaining cue timing; local inference and selected embedded-text workflows are available.", "limits": "Source languages, subtitle types and playback routes have explicit limits. Translation quality varies by model and language.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F08", "title": "System caption appearance", "category": "Subtitles", "status": "completed", "scope": "Supported owned text renderers use system caption font, size, color, opacity, background and edge preferences.", "limits": "Appearance behavior is not identical across every native, compatibility, HDR and PiP route.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F09", "title": "Clip recording", "category": "Recording and export", "status": "completed", "scope": "Encoded clip recording is available from supported owned H.264/HEVC playback and the live TS bridge.", "limits": "Other native HLS/MP4, compatibility, Dolby, independent-input and repeat routes are excluded. Recording availability is explicit.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F11", "title": "Subtitles on HDR video", "category": "Subtitles", "status": "completed", "scope": "Eligible PQ video can use subtitle composition with an explicit caption-white luminance policy.", "limits": "Dynamic Dolby Vision and HDR10+ composition are excluded from this path. No universal HDR subtitle-effects or display-conformance claim.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F12", "title": "Downloads and conversion", "category": "Recording and export", "status": "completed", "scope": "Selected media downloading, cache staging and packet-copy container conversion are implemented.", "limits": "General-purpose transcoding, arbitrary format conversion and a complete durable download/export product workflow are not included.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F13", "title": "External image subtitles", "category": "Subtitles", "status": "completed", "scope": "External SUP/PGS subtitles support bounded import, timed display, selection, seek and clearing on supported routes.", "limits": "Malformed-source, HDR composition and device/backend coverage have limits; not every image-subtitle format is supported.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F14", "title": "Dual subtitle tracks", "category": "Subtitles", "status": "completed", "scope": "Primary and secondary subtitle slots have independent selection, timing, layout and cleanup.", "limits": "Native live/HLS/DRM, secondary closed captions and some PiP combinations are not all supported.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F15", "title": "Offline rolling translation", "category": "AI and accessibility", "status": "completed", "scope": "Local inference can translate selected English text cues continuously on the supported owned-primary route without scanning an entire remote file.", "limits": "Native, compatibility, FEL and bitmap routes are excluded. Sustained real-time performance and language quality depend on the device and model.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F16", "title": "Picture adjustments", "category": "Video processing", "status": "completed", "scope": "Supported SDR output has saturation, brightness and contrast controls with bounded processing resources.", "limits": "Nonneutral HDR and Dolby Vision picture adjustments are unavailable. SDR picture controls and optional video upscaling are separate settings.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F17", "title": "Subtitles in Picture in Picture", "category": "Presentation", "status": "completed", "scope": "Eligible owned subtitle composition can carry captions into supported PiP output.", "limits": "Owned sample-buffer PiP is not available on tvOS through the same route; HDR, native and compatibility combinations have limits.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F18", "title": "Annex-B hardware decoding", "category": "Formats", "status": "completed", "scope": "Actual Annex-B hardware decode paths exist, including the dual-layer FEL pipeline.", "limits": "General raw elementary-stream and low-latency live coverage across all codecs is not complete.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F19", "title": "Embedded subtitle fonts", "category": "Subtitles", "status": "completed", "scope": "Bounded embedded font attachments feed the actual libass renderer.", "limits": "Font collections, fallback behavior, untrusted inputs and backend-specific presentation retain compatibility limits.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F20", "title": "Fast short-range seeks", "category": "Networking and storage", "status": "completed", "scope": "A bounded, representation-pinned compressed-byte cache can reuse nearby source data during seeks.", "limits": "Latency depends on indexing, decoder work and provider validation; no fixed seek-time guarantee.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F21", "title": "Broad container and codec playback", "category": "Formats", "status": "completed", "scope": "Playback paths cover common MP4, MKV, AVI and TS sources with multiple audio and video codecs.", "limits": "Backend selection matters. The SDK does not support every possible format, codec profile or damaged file.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F22", "title": "ASS subtitle effects", "category": "Subtitles", "status": "completed", "scope": "Real libass rendering supports styled subtitle images, embedded fonts and authored effects.", "limits": "Universal ASS effect fidelity, animation, HDR and all-route reference parity are not claimed.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F23", "title": "Video recording", "category": "Recording and export", "status": "completed", "scope": "The same encoded recording implementation described by clip recording is available on its supported routes.", "limits": "This is a duplicate catalogue requirement, not a second recorder. The clip-recording exclusions apply.", "duplicates": "F09", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F24", "title": "4K and HDR playback", "category": "HDR and Dolby", "status": "completed", "scope": "4K and eligible HDR/HDR10 playback and output paths are implemented.", "limits": "Codec profile, device and route limits apply; display mode, color conformance and sustained delivery require appropriate hardware validation.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F26", "title": "Picture in Picture", "category": "Presentation", "status": "completed", "scope": "Native PiP and supported owned iPhone routes have integrated lifecycle and restoration support.", "limits": "FEL, compatibility and owned tvOS routes are not universally covered; host scene and audio ownership must be integrated correctly.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F27", "title": "Hardware acceleration", "category": "Video processing", "status": "completed", "scope": "Supported VideoToolbox decode and Metal processing paths use Apple hardware acceleration.", "limits": "Acceleration is codec-, device- and route-dependent; software paths remain necessary for some media.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F28", "title": "Automatic interlace detection", "category": "Video processing", "status": "completed", "scope": "Explicit source field metadata drives supported deinterlacing policy and unsupported-state reporting.", "limits": "Unknown field order is not guessed. Wider codecs and physical field cadence need route-specific validation.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F29", "title": "Multichannel PCM audio", "category": "Audio", "status": "completed", "scope": "Up to eight PCM channels and CoreAudio channel labels are supported on eligible routes.", "limits": "Output depends on the device and selected audio route. Multichannel PCM and channel mapping are distinct from receiver-confirmed Atmos or object-audio passthrough.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F30", "title": "SMB and NFS sources", "category": "Networking and storage", "status": "completed", "scope": "Bounded authenticated SMB and trusted-network NFS file access, identity checks and directory browsing are implemented.", "limits": "NAS compatibility and credential workflows depend on host integration. NFS AUTH_SYS is limited to trusted networks.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F31", "title": "Text, image and closed captions", "category": "Subtitles", "status": "completed", "scope": "Text, styled ASS, image subtitles and supported closed-caption paths are implemented.", "limits": "Selection, style and composition coverage varies by format and backend; not all combinations are available.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F32", "title": "Range looping", "category": "Playback controls", "status": "completed", "scope": "The owned playback path has coordinated audio/video looping within a selected range.", "limits": "Other backends and perceptually seamless long-running boundaries are not universally verified.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F33", "title": "Online subtitle providers", "category": "Subtitles", "status": "completed", "scope": "Adapters for OpenSubtitles, ASSRT and Shooter feed supported subtitle import and selection workflows.", "limits": "Provider accounts, quotas, configuration and service availability are external requirements; archive extraction and some delay cases are unsupported.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." }, { "id": "F35", "title": "Adaptive bitrate HLS", "category": "Live TV", "status": "completed", "scope": "Native HLS uses AVPlayer adaptive variant selection, with exposed buffering policy and observed downshift and recovery behavior.", "limits": "Provider/CDN conditions, waiting and stalls remain workload-dependent. No universal uninterrupted or fixed adaptation-time guarantee. November 4: the confirmed finite HEVC-in-TS HLS video gap is corrected in the BOSS development SDK and passes native Mac acceptance. Finite, continuous, unencrypted MPEG-TS HLS media playlists with range-capable segments. No whole-media download or persistent movie/library file. Encoded video and metadata are unchanged. Adaptive/master, encrypted, byte-range, discontinuity, partial/low-latency and live graphs retain existing routing and are outside this correction.", "completionScope": "Implementation completed for the described supported scope; source, platform and integration limits remain." } ], "updatedAt": "2026-11-04", "recentChanges": [ { "id": "spatial-output", "title": "Original PCM, Spatial PCM and APAC output", "status": "implemented-preview", "scope": "Original decoded PCM, supported TrueHD Atmos/DTS:X rendering into 7.1.4 PCM, and optional lossy APAC Spatial Audio at the current 4.096 Mbit/s target. Current spatial rendering requires supported 48 kHz input; APAC needs supported OS 26+ APIs and an appropriate output route.", "limits": "Rendered speaker channels are distinct from the original object bitstream. Receiver-confirmed object/height fidelity and all-device acceptance remain open." }, { "id": "actual-output-stats", "title": "Report the actual output signal", "status": "implemented", "scope": "Expose actual submitted sample rate, format, channel layout and height count, compressed payload bitrate, queue lead and renderer diagnostics. Keep requested mode and detected source information separate from actual output.", "limits": "Unknown observations stay unknown; they must not be replaced with requested or advertised values." }, { "id": "bounded-fel-audio", "title": "Bounded FEL/audio scheduling", "status": "implemented-source", "scope": "The latest owned FEL path bounds audio lookahead to 150 ms and retains bounded queues, so an audio producer cannot run arbitrarily ahead of reconstruction.", "limits": "This source review and the format matrix do not measure FEL GPU time, RPU/EL synchronization or television output." }, { "id": "fel-presentation", "title": "FEL presentation and display diagnostics", "status": "implemented-source", "scope": "Carry the current high-precision reconstruction, frame/display binding and diagnostic changes into standalone BOSS. Existing Odyssey-accepted P5, P7 MEL, P7 FEL and P8 scopes remain in the capability catalogue.", "limits": "No additional profile, original P7 output, HDMI qualification or receiver certification is inferred from this update." }, { "id": "subtitle-placement", "title": "Subtitle placement and failure recovery", "status": "implemented-source", "scope": "Independent subtitle vertical placement with clamped lift, dual-subtitle collision handling and bounded ASS-history recovery without restarting the whole audio/video session.", "limits": "Exact subtitle/font/source combinations still require app-level acceptance." }, { "id": "playback-recovery", "title": "Audio interruption and route handoff recovery", "status": "implemented-source", "scope": "Refresh interrupted-audio preparation, native/owned handoff, shared FEL HTTP access and PCM replay/live recovery support.", "limits": "Source alignment does not establish that every customer network failure or active Odyssey app build has been repaired." }, { "id": "mac-disc-packaging", "title": "Matching Mac disc framework slice", "status": "compiled-only", "scope": "Correct the stale Mac disc ABI in the standalone development SDK using the matching streaming-capable slice. The complete native macOS SDK compiles.", "limits": "Disc menus and physical disc playback were not tested in this benchmark." }, { "id": "finite-hevc-hls", "title": "Seekable finite HEVC-in-TS HLS", "status": "implemented-native-Mac-validated", "scope": "Finite, continuous, unencrypted MPEG-TS HLS media playlists with range-capable segments. No whole-media download or persistent movie/library file. Encoded video and metadata are unchanged. Adaptive/master, encrypted, byte-range, discontinuity, partial/low-latency and live graphs retain existing routing and are outside this correction.", "limits": "16 playback controls, real seek-frame timestamps and 3 focused regressions pass. New consumer-app builds and other-device acceptance remain separate." } ], "knownIssues": [ { "id": "other-hevc-hls-graphs", "status": "not-covered-by-finite-fix", "scope": "Adaptive, live, protected and discontinuous HEVC-in-TS HLS require separate coverage and acceptance." } ], "benchmarkReport": "/player/docs/updates/", "benchmarkCorrections": { "date": "2026-11-04", "status": "implemented-and-native-Mac-validated", "scope": "Finite, continuous, unencrypted MPEG-TS HLS media playlists with range-capable segments. No whole-media download or persistent movie/library file. Encoded video and metadata are unchanged. Adaptive/master, encrypted, byte-range, discontinuity, partial/low-latency and live graphs retain existing routing and are outside this correction.", "runs": 16, "seekClockLandings": 38, "unitRegressionsPassed": 3, "ownedSeekVideoWitness": "Frames were submitted near targets at 12, 90 and 4 seconds for plain, timestamp-offset and authorized HEVC HLS.", "authorizationRevocation": "Stopped with expected error -20002", "headerGateFailures": 0, "maximumTeardownSeconds": 0.10967337500187568, "appInstalledOrUploaded": false, "odysseyAppModified": false, "tradeoff": "An initial one-byte range request per segment establishes the finite byte index; long playlists add setup requests. No claim of optimal startup for every CDN." } }