plexpy/docs/models/operations/transcodesubtitlesrequest.md

TranscodeSubtitlesRequest

Fields

Field	Type	Required	Description	Example
accepts	Optional[components.Accepts]	➖	Indicates the client accepts the indicated media types
client_identifier	Optional[str]	➖	An opaque identifier unique to the client	abc123
product	Optional[str]	➖	The name of the client product	Plex for Roku
version	Optional[str]	➖	The version of the client application	2.4.1
platform	Optional[str]	➖	The platform of the client	Roku
platform_version	Optional[str]	➖	The version of the platform	4.3 build 1057
device	Optional[str]	➖	A relatively friendly name for the client device	Roku 3
model	Optional[str]	➖	A potentially less friendly identifier for the device model	4200X
device_vendor	Optional[str]	➖	The device vendor	Roku
device_name	Optional[str]	➖	A friendly name for the client	Living Room TV
marketplace	Optional[str]	➖	The marketplace on which the client application is distributed	googlePlay
transcode_type	components.TranscodeType	✔️	Type of transcode media
transcode_session_id	Optional[str]	➖	Transcode session UUID
advanced_subtitles	Optional[components.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
audio_boost	Optional[int]	➖	Percentage of original audio loudness to use when transcoding (100 is equivalent to original volume, 50 is half, 200 is double, etc)	50
audio_channel_count	Optional[int]	➖	Target video number of audio channels.	5
auto_adjust_quality	Optional[components.BoolInt]	➖	Indicates the client supports ABR.	1
auto_adjust_subtitle	Optional[components.BoolInt]	➖	Indicates if the server should adjust subtitles based on Voice Activity Data.	1
direct_play	Optional[components.BoolInt]	➖	Indicates the client supports direct playing the indicated content.	1
direct_stream	Optional[components.BoolInt]	➖	Indicates the client supports direct streaming the video of the indicated content.	1
direct_stream_audio	Optional[components.BoolInt]	➖	Indicates the client supports direct streaming the audio of the indicated content.	1
disable_resolution_rotation	Optional[components.BoolInt]	➖	Indicates if resolution should be adjusted for orientation.	1
has_mde	Optional[components.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[operations.QueryParamLocation]	➖	Network type of the client, can be used to help determine target bitrate.	wan
media_buffer_size	Optional[int]	➖	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
media_index	Optional[int]	➖	Index of the media to transcode. -1 or not specified indicates let the server choose.	0
music_bitrate	Optional[int]	➖	Target bitrate for audio only files (in kbps, used to transcode).	5000
offset	Optional[float]	➖	Offset from the start of the media (in seconds).	90.5
part_index	Optional[int]	➖	Index of the part to transcode. -1 or not specified indicates the server should join parts together in a transcode	0
path	Optional[str]	➖	Internal PMS path of the media to transcode.	/library/metadata/151671
peak_bitrate	Optional[int]	➖	Maximum bitrate (in kbps) to use in ABR.	12000
photo_resolution	Optional[str]	➖	Target photo resolution.	1080x1080
protocol	Optional[operations.QueryParamProtocol]	➖	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
seconds_per_segment	Optional[int]	➖	Number of seconds to include in each transcoded segment	5
subtitle_size	Optional[int]	➖	Percentage of original subtitle size to use when burning subtitles (100 is equivalent to original size, 50 is half, ect)	50
subtitles	Optional[operations.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
video_bitrate	Optional[int]	➖	Target video bitrate (in kbps).	12000
video_quality	Optional[int]	➖	Target photo quality.	50
video_resolution	Optional[str]	➖	Target maximum video resolution.	1080x1080
x_plex_client_profile_extra	Optional[str]	➖	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)
x_plex_client_profile_name	Optional[str]	➖	Which built in Client Profile to use in the decision. Generally should only be used to specify the Generic profile.	generic
x_plex_session_identifier	Optional[str]	➖	Unique per client playback session. Used if a client can playback multiple items at a time (such as a browser with multiple tabs)