Bring Your Own Renditions ᴮᴱᵀᴬ Overview

👍

This is a beta offering. You can request access to this beta feature through your JWP Account Manager.
By using this documentation, you are agreeing to abide by the terms of the JWP Beta Program Agreement.

Bring Your Own Renditions (BYOR) gives you control over your video quality and playback experience by allowing you to upload and manage custom renditions directly in the JW Platform.

A custom rendition is a video, audio, or text file that you have transcoded outside of JWP’s automated pipeline. These renditions follow your own specifications for quality, bitrate ladders, codecs, captions, or audio formats, and are delivered through JWP’s streaming infrastructure.

This approach is valuable for broadcasters who:

Precise control over quality and bitrate ladders
Have already transcoded VOD renditions from their hardware encoders

Once uploaded, your renditions are delivered through JWP’s streaming infrastructure, ensuring compatibility with HLS and DASH workflows, digital rights management, analytics, and advertising.

Features

Feature	Description
Flexible playback support	Deliver media through JWPC’s infrastructure with HLS and DASH manifests, trickplay, content protection (including DRM), streaming analytics, and ad integrations.
Advanced media support	Supports delivery and management of any custom use case, including 4K media in any CMAF format, surround sound (including Dolby Atmos), HDR (HDR10+ or Dolby Vision), and more.
Dashboard management	Upload and manage renditions manually from the Media Details page or programmatically using our Management API.

Custom renditions guidelines

To ensure smooth delivery, all uploaded renditions must meet the following specifications.

Category	Guidelines
Rendition limits per media item	Up to 16 video renditions Up to 32 audio renditions Up to 48 text renditions
File format	Must be in CMAF with `cmfc` or `cmf2` compatible files Each file must contain exactly one track
File structure	Must include a sidx (Segment Index) box Segment durations must be constant within a file Segments must start on an I-frame and end on a closed GoP *Recommended:* Align segment durations across all video renditions and across all audio renditions for smoother ABR playback
Supported codecs	Video: H.264 HEVC (H.265) Audio: AAC Text: WebVTT MP4 container formats: .mov .mp4 .m4a .3gp .3g2 .mj2

📘
Please note the following.
Kind values:
If you want to define kind values for audio or text tracks, set them in the CMAF file. Suggested kind values are returned in the 201 response bodies of the endpoints for creating custom audio and text renditions.
Multiple audio renditions:
When uploading multiple audio renditions, you must upload the same number of audio renditions for every language to adhere to HLS specifications. Audio renditions for different languages should have the same bitrate (rounded down to the nearest KB). This applies to all steps in an audio bitrate ladder.