TranscodeSubtitlesRequest.md

TranscodeSubtitlesRequest

Fields

Field	Type	Required	Description	Example
accepts	Optional<Accepts>	➖	Indicates the client accepts the indicated media types
clientIdentifier	Optional<String>	➖	An opaque identifier unique to the client	abc123
product	Optional<String>	➖	The name of the client product	Plex for Roku
version	Optional<String>	➖	The version of the client application	2.4.1
platform	Optional<String>	➖	The platform of the client	Roku
platformVersion	Optional<String>	➖	The version of the platform	4.3 build 1057
device	Optional<String>	➖	A relatively friendly name for the client device	Roku 3
model	Optional<String>	➖	A potentially less friendly identifier for the device model	4200X
deviceVendor	Optional<String>	➖	The device vendor	Roku
deviceName	Optional<String>	➖	A friendly name for the client	Living Room TV
marketplace	Optional<String>	➖	The marketplace on which the client application is distributed	googlePlay
transcodeType	TranscodeType	✔️	Type of transcode media
transcodeSessionId	Optional<String>	➖	Transcode session UUID
advancedSubtitles	Optional<AdvancedSubtitles>	➖	Indicates how incompatible advanced subtitles (such as ass/ssa) should be included: * 'burn' - Burn incompatible advanced text subtitles into the video stream * 'text' - Transcode incompatible advanced text subtitles to a compatible text format, even if some markup is lost	burn
platformQueryParameter	Optional<String>	➖	Client platform (some clients send this in addition to headers).
audioBoost	Optional<Long>	➖	Percentage of original audio loudness to use when transcoding (100 is equivalent to original volume, 50 is half, 200 is double, etc)	50
audioChannelCount	Optional<Long>	➖	Target video number of audio channels.	5
autoAdjustQuality	Optional<BoolInt>	➖	Indicates the client supports ABR.	1
autoAdjustSubtitle	Optional<BoolInt>	➖	Indicates if the server should adjust subtitles based on Voice Activity Data.	1
directPlay	Optional<BoolInt>	➖	Indicates the client supports direct playing the indicated content.	1
directStream	Optional<BoolInt>	➖	Indicates the client supports direct streaming the video of the indicated content.	1
directStreamAudio	Optional<BoolInt>	➖	Indicates the client supports direct streaming the audio of the indicated content.	1
disableResolutionRotation	Optional<BoolInt>	➖	Indicates if resolution should be adjusted for orientation.	1
hasMDE	Optional<BoolInt>	➖	Ignore client profiles when determining if direct play is possible. Only has an effect when directPlay=1 and both mediaIndex and partIndex are specified and neither are -1	1
location	Optional<QueryParamLocation>	➖	Network type of the client, can be used to help determine target bitrate.	wan
mediaBufferSize	Optional<Long>	➖	Buffer size used in playback (in KB). Clients should specify a lower bound if not known exactly. This value could make the difference between transcoding and direct play on bandwidth constrained networks.	102400
mediaIndex	Optional<Long>	➖	Index of the media to transcode. -1 or not specified indicates let the server choose.	0
musicBitrate	Optional<Long>	➖	Target bitrate for audio only files (in kbps, used to transcode).	5000
offset	Optional<Double>	➖	Offset from the start of the media (in seconds).	90.5
partIndex	Optional<Long>	➖	Index of the part to transcode. -1 or not specified indicates the server should join parts together in a transcode	0
path	Optional<String>	➖	Internal PMS path of the media to transcode.	/library/metadata/151671
peakBitrate	Optional<Long>	➖	Maximum bitrate (in kbps) to use in ABR.	12000
photoResolution	Optional<String>	➖	Target photo resolution.	1080x1080
protocol	Optional<TranscodeSubtitlesQueryParamProtocol>	➖	Indicates the network streaming protocol to be used for the transcode session: * 'http' - include the file in the http response such as MKV streaming * 'hls' - hls stream (RFC 8216) * 'dash' - dash stream (ISO/IEC 23009-1:2022)	dash
secondsPerSegment	Optional<Long>	➖	Number of seconds to include in each transcoded segment	5
subtitleSize	Optional<Long>	➖	Percentage of original subtitle size to use when burning subtitles (100 is equivalent to original size, 50 is half, ect)	50
subtitles	Optional<QueryParamSubtitles>	➖	Indicates how subtitles should be included: * 'auto' - Compute the appropriate subtitle setting automatically * 'burn' - Burn the selected subtitle; auto if no selected subtitle * 'none' - Ignore all subtitle streams * 'sidecar' - The selected subtitle should be provided as a sidecar * 'embedded' - The selected subtitle should be provided as an embedded stream * 'segmented' - The selected subtitle should be provided as a segmented stream	burn
maxVideoBitrate	Optional<Long>	➖	Client-side maximum video bitrate cap in kbps
videoResolution	Optional<String>	➖	Cap resolution string (e.g. 1920x1080)
copyts	Optional<BoolInt>	➖	Copy timestamps instead of re-encoding them	1
videoBitrate	Optional<Long>	➖	Target video bitrate (in kbps).	12000
videoQuality	Optional<Long>	➖	Target photo quality.	50
xPlexClientProfileExtra	Optional<String>	➖	See Profile Augmentations .	add-limitation(scope=videoCodec&scopeName=*&type=upperBound&name=video.frameRate&value=60&replace=true)+append-transcode-target-codec(type=videoProfile&context=streaming&videoCodec=h264%2Chevc&audioCodec=aac&protocol=dash)
xPlexClientProfileName	Optional<String>	➖	Which built in Client Profile to use in the decision. Generally should only be used to specify the Generic profile.	generic
xPlexSessionIdentifier	Optional<String>	➖	Unique per client playback session. Used if a client can playback multiple items at a time (such as a browser with multiple tabs)