> ## Documentation Index
> Fetch the complete documentation index at: https://personal-92-migrate-dev-docs-guides.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Transcode subtitles
> Only transcode subtitle streams.
## OpenAPI
````yaml /openapi-with-code-samples.yaml get /{transcodeType}/:/transcode/universal/subtitles
openapi: 3.1.1
info:
title: Plex Media Server
version: 1.1.1
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://{IP-description}.{identifier}.plex.direct:{port}
variables:
identifier:
description: The unique identifier of this particular PMS
default: 0123456789abcdef0123456789abcdef
IP-description:
description: A `-` separated string of the IPv4 or IPv6 address components
default: 1-2-3-4
port:
default: '32400'
- url: '{protocol}://{host}:{port}'
variables:
protocol:
description: The network protocol to use. Typically (`http` or `https`)
default: http
host:
description: >
The Host of the PMS.
If using on a local network, this is the internal IP address of the
server hosting the PMS.
If using on an external network, this is the external IP address for
your network, and requires port forwarding.
If using a reverse proxy, this would be the external DNS domain for
your network, and requires the proxy handle port forwarding.
default: localhost
port:
description: >
The Port number configured on the PMS. Typically (`32400`).
If using a reverse proxy, this would be the port number configured on
the proxy.
default: '32400'
- url: '{full_server_url}'
variables:
full_server_url:
description: The full manual URL to access the PMS
default: http://localhost:32400
security:
- token:
- shared user
- admin
tags:
- name: Activities
description: >
Activities provide a way to monitor and control asynchronous operations on
the server. In order to receive real-time updates for activities, a client
would normally subscribe via either EventSource or Websocket endpoints.
Activities are associated with HTTP replies via a special
`X-Plex-Activity` header which contains the UUID of the activity.
Activities are optional cancellable. If cancellable, they may be cancelled
via the `DELETE` endpoint.
- name: Butler
description: >-
The butler is responsible for running periodic tasks. Some tasks run
daily, others every few days, and some weekly. These includes database
maintenance, metadata updating, thumbnail generation, media analysis, and
other tasks.
- name: Collections
description: API Operations against the Collections
- name: Content
description: The actual content of the media provider
- name: Devices
description: >
Media grabbers provide ways for media to be obtained for a given protocol.
The simplest ones are `stream` and `download`. More complex grabbers can
have associated devices
Network tuners can present themselves on the network using the Simple
Service Discovery Protocol and Plex Media Server will discover them. The
following XML is an example of the data returned from SSDP. The
`deviceType`, `serviceType`, and `serviceId` values must remain as they
are in the example in order for PMS to properly discover the device. Other
less-obvious fields are described in the parameters section below.
Example SSDP output
```
1
0
urn:plex-tv:device:Media:1
Turing Hopper 3000
Plex, Inc.
https://plex.tv/
Turing Hopper 3000 Media Grabber
Plex Media Grabber
1
https://plex.tv
uuid:42fde8e4-93b6-41e5-8a63-12d848655811
http://10.0.0.5:8088
urn:plex-tv:service:MediaGrabber:1
urn:plex-tv:serviceId:MediaGrabber
```
- UDN: (string) A UUID for the device. This should be unique across models of a device at minimum.
- URLBase: (string) The base HTTP URL for the device from which all of the other endpoints are hosted.
- name: Download Queue
description: API Operations against the Download Queue
- name: DVRs
description: >
The DVR provides means to watch and record live TV. This section of
endpoints describes how to setup the DVR itself
- name: EPG
description: >
The EPG (Electronic Program Guide) is responsible for obtaining metadata
for what is airing on each channel and when
- name: Events
description: >
The server can notify clients in real-time of a wide range of events, from
library scanning, to preferences being modified, to changes to media, and
many other things. This is also the mechanism by which activity progress
is reported.
Two protocols for receiving the events are available: EventSource (also
known as SSE), and WebSocket.
- name: General
description: >-
General endpoints for basic PMS operation not specific to any media
provider
- name: Hubs
description: The hubs within a media provider
- name: Library
description: >-
Library endpoints which are outside of the Media Provider API. Typically
this is manipulation of the library (adding/removing sections, modifying
preferences, etc).
- name: Library Collections
description: >-
Endpoints for manipulating collections. In addition to these endpoints,
`/library/collections/:collectionId/X` will be rerouted to
`/library/metadata/:collectionId/X` and respond to those endpoints as
well.
x-displayName: 'Library: Collections'
- name: Library Playlists
description: Endpoints for manipulating playlists.
x-displayName: 'Library: Playlists'
- name: Live TV
description: |
LiveTV contains the playback sessions of a channel from a DVR device
- name: Log
description: Logging mechanism to allow clients to log to the server
- name: Play Queue
description: >-
The playqueue feature within a media provider
A play queue represents the current list of media for playback. Although
queues are persisted by the server, they should be regarded by the user as
a fairly lightweight, an ephemeral list of items queued up for playback in
a session. There is generally one active queue for each type of media
(music, video, photos) that can be added to or destroyed and replaced with
a fresh queue.
Play Queues has a region, which we refer to in this doc (partially for
historical reasons) as "Up Next". This region is defined by
`playQueueLastAddedItemID` existing on the media container. This follows
iTunes' terminology. It is a special region after the currently playing
item but before the originally-played items. This enables "Party Mode"
listening/viewing, where items can be added on-the-fly, and normal queue
playback resumed when completed.
You can visualize the play queue as a sliding window in the complete list
of media queued for playback. This model is important when scaling to
larger play queues (e.g. shuffling 40,000 audio tracks). The client only
needs visibility into small areas of the queue at any given time, and the
server can optimize access in this fashion.
All created play queues will have an empty "Up Next" area - unless the
item is an album and no `key` is provided. In this case the "Up Next" area
will be populated by the contents of the album. This is to allow queueing
of multiple albums - since the 'Add to Up Next' will insert after all the
tracks. This means that If you're creating a PQ from an album, you can
only shuffle it if you set `key`. This is due to the above implicit
queueing of albums when no `key` is provided as well as the current
limitation that you cannot shuffle a PQ with an "Up Next" area.
The play queue window advances as the server receives timeline requests.
The client needs to retrieve the play queue as the “now playing” item
changes. There is no play queue API to update the playing item.
- name: Playlist
description: Media playlists that can be created and played back
- name: Preferences
description: API Operations against the Preferences
- name: Provider
description: >-
Media providers are the starting points for the entire Plex Media Server
media library API. It defines the paths for the groups of endpoints. The
`/media/providers` should be the only hard-coded path in clients when
accessing the media library. Non-media library endpoints are outside the
scope of the media provider. See the description in See [the section in
API Info](#section/API-Info/Media-Providers) for more information on how
to use media providers.
- name: Rate
description: Operations for rating media items (thumbs up/down, star ratings, etc.)
- name: Search
description: The search feature within a media provider
- name: Status
description: >-
The status endpoints give you information about current playbacks, play
history, and even terminating sessions.
- name: Subscriptions
description: >
Subscriptions determine which media will be recorded and the criteria for
selecting an airing when multiple are available
- name: Timeline
description: The actions feature within a media provider
- name: Transcoder
description: API Operations against the Transcoder
- name: UltraBlur
description: Service provided to compute UltraBlur colors and images.
- name: Updater
description: >
This describes the API for searching and applying updates to the Plex
Media Server.
Updates to the status can be observed via the Event API.
paths:
/{transcodeType}/:/transcode/universal/subtitles:
get:
tags:
- Transcoder
summary: Transcode subtitles
description: Only transcode subtitle streams.
operationId: transcodeSubtitles
parameters:
- $ref: '#/components/parameters/accepts'
- $ref: '#/components/parameters/X-Plex-Client-Identifier'
- $ref: '#/components/parameters/X-Plex-Product'
- $ref: '#/components/parameters/X-Plex-Version'
- $ref: '#/components/parameters/X-Plex-Platform'
- $ref: '#/components/parameters/X-Plex-Platform-Version'
- $ref: '#/components/parameters/X-Plex-Device'
- $ref: '#/components/parameters/X-Plex-Model'
- $ref: '#/components/parameters/X-Plex-Device-Vendor'
- $ref: '#/components/parameters/X-Plex-Device-Name'
- $ref: '#/components/parameters/X-Plex-Marketplace'
- $ref: '#/components/parameters/transcodeType'
- $ref: '#/components/parameters/transcodeSessionId'
- $ref: '#/components/parameters/advancedSubtitles'
- name: audioBoost
description: >-
Percentage of original audio loudness to use when transcoding (100
is equivalent to original volume, 50 is half, 200 is double, etc)
in: query
schema:
type: integer
minimum: 1
example: 50
- name: audioChannelCount
description: Target video number of audio channels.
in: query
schema:
type: integer
minimum: 1
maximum: 8
example: 5
- name: autoAdjustQuality
description: Indicates the client supports ABR.
in: query
schema:
$ref: '#/components/schemas/BoolInt'
example: 1
- name: autoAdjustSubtitle
description: >-
Indicates if the server should adjust subtitles based on Voice
Activity Data.
in: query
schema:
$ref: '#/components/schemas/BoolInt'
example: 1
- name: directPlay
description: Indicates the client supports direct playing the indicated content.
in: query
schema:
$ref: '#/components/schemas/BoolInt'
example: 1
- name: directStream
description: >-
Indicates the client supports direct streaming the video of the
indicated content.
in: query
schema:
$ref: '#/components/schemas/BoolInt'
example: 1
- name: directStreamAudio
description: >-
Indicates the client supports direct streaming the audio of the
indicated content.
in: query
schema:
$ref: '#/components/schemas/BoolInt'
example: 1
- name: disableResolutionRotation
description: Indicates if resolution should be adjusted for orientation.
in: query
schema:
$ref: '#/components/schemas/BoolInt'
example: 1
- name: hasMDE
description: >-
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
in: query
schema:
$ref: '#/components/schemas/BoolInt'
example: 1
- name: location
description: >-
Network type of the client, can be used to help determine target
bitrate.
in: query
schema:
type: string
enum:
- lan
- wan
- cellular
example: wan
- name: mediaBufferSize
description: >-
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.
in: query
schema:
type: integer
example: 102400
- name: mediaIndex
description: >-
Index of the media to transcode. -1 or not specified indicates let
the server choose.
in: query
schema:
type: integer
example: 0
- name: musicBitrate
description: Target bitrate for audio only files (in kbps, used to transcode).
in: query
schema:
type: integer
minimum: 0
example: 5000
- name: offset
description: Offset from the start of the media (in seconds).
in: query
schema:
type: number
example: 90.5
- name: partIndex
description: >-
Index of the part to transcode. -1 or not specified indicates the
server should join parts together in a transcode
in: query
schema:
type: integer
example: 0
- name: path
description: Internal PMS path of the media to transcode.
in: query
schema:
type: string
example: /library/metadata/151671
- name: peakBitrate
description: Maximum bitrate (in kbps) to use in ABR.
in: query
schema:
type: integer
minimum: 0
example: 12000
- name: photoResolution
description: Target photo resolution.
in: query
schema:
type: string
pattern: ^\d[x:]\d$
example: 1080x1080
- name: protocol
description: >
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)
in: query
schema:
type: string
enum:
- http
- hls
- dash
example: dash
- name: secondsPerSegment
description: Number of seconds to include in each transcoded segment
in: query
schema:
type: integer
example: 5
- name: subtitleSize
description: >-
Percentage of original subtitle size to use when burning subtitles
(100 is equivalent to original size, 50 is half, ect)
in: query
schema:
type: integer
minimum: 1
example: 50
- name: subtitles
description: >
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
in: query
schema:
type: string
enum:
- auto
- burn
- none
- sidecar
- embedded
- segmented
- unknown
example: Burn
- name: videoBitrate
description: Target video bitrate (in kbps).
in: query
schema:
type: integer
minimum: 0
example: 12000
- name: videoQuality
description: Target photo quality.
in: query
schema:
type: integer
minimum: 0
maximum: 99
example: 50
- name: videoResolution
description: Target maximum video resolution.
in: query
schema:
type: string
pattern: ^\d[x:]\d$
example: 1080x1080
- name: X-Plex-Client-Identifier
description: Unique per client.
in: header
required: true
schema:
type: string
- name: X-Plex-Client-Profile-Extra
description: >-
See [Profile Augmentations](#section/API-Info/Profile-Augmentations)
.
in: header
schema:
type: string
example: >-
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)
- name: X-Plex-Client-Profile-Name
description: >-
Which built in Client Profile to use in the decision. Generally
should only be used to specify the Generic profile.
in: header
schema:
type: string
example: generic
- name: X-Plex-Device
description: Device the client is running on
in: header
schema:
type: string
example: Windows
- name: X-Plex-Model
description: Model of the device the client is running on
in: header
schema:
type: string
example: standalone
- name: X-Plex-Platform
description: Client Platform
in: header
schema:
type: string
example: Chrome
- name: X-Plex-Platform-Version
description: Client Platform Version
in: header
schema:
type: string
example: 135
- name: X-Plex-Session-Identifier
description: >-
Unique per client playback session. Used if a client can playback
multiple items at a time (such as a browser with multiple tabs)
in: header
schema:
type: string
responses:
'200':
description: Transcoded subtitle file
content:
text/srt:
example: |
1
00:00:02,499 --> 00:00:06,416
[SERENE MUSIC]
2
00:00:11,791 --> 00:00:13,958
[BROOK BABBLES]
[FLY BUZZES]
3
00:00:16,166 --> 00:00:17,666
[BIRD TWEETS]
4
00:00:17,666 --> 00:00:18,708
[WINGS FLAP]
5
00:00:19,833 --> 00:00:20,374
[BIRD TWEETS]
[WINGS FLAP]
6
00:00:20,374 --> 00:00:21,041
[THUD]
7
00:00:21,374 --> 00:00:22,249
[THUD]
8
00:00:22,249 --> 00:00:23,083
[SQUIRREL LAUGHS]
9
00:00:26,249 --> 00:00:27,541
[SNORES]
10
00:00:29,416 --> 00:00:30,708
[SNORES]
11
00:00:32,749 --> 00:00:34,041
[BUNNY SNORES]
12
00:00:35,916 --> 00:00:37,249
[BUNNY SNORES]
'400':
$ref: '#/components/responses/400'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
x-codeSamples:
- lang: go
label: PlexGO
source: "package main\n\nimport(\n\t\"context\"\n\t\"github.com/LukeHagar/plexgo/models/components\"\n\t\"github.com/LukeHagar/plexgo\"\n\t\"github.com/LukeHagar/plexgo/models/operations\"\n\t\"log\"\n)\n\nfunc main() {\n ctx := context.Background()\n\n s := plexgo.New(\n plexgo.WithAccepts(components.AcceptsApplicationXML),\n plexgo.WithClientIdentifier(\"abc123\"),\n plexgo.WithProduct(\"Plex for Roku\"),\n plexgo.WithVersion(\"2.4.1\"),\n plexgo.WithPlatform(\"Roku\"),\n plexgo.WithPlatformVersion(\"4.3 build 1057\"),\n plexgo.WithDevice(\"Roku 3\"),\n plexgo.WithModel(\"4200X\"),\n plexgo.WithDeviceVendor(\"Roku\"),\n plexgo.WithDeviceName(\"Living Room TV\"),\n plexgo.WithMarketplace(\"googlePlay\"),\n plexgo.WithSecurity(\"\"),\n )\n\n res, err := s.Transcoder.TranscodeSubtitles(ctx, operations.TranscodeSubtitlesRequest{\n TranscodeType: components.TranscodeTypeAudio,\n AdvancedSubtitles: components.AdvancedSubtitlesBurn.ToPointer(),\n AudioBoost: plexgo.Pointer[int64](50),\n AudioChannelCount: plexgo.Pointer[int64](5),\n AutoAdjustQuality: components.BoolIntTrue.ToPointer(),\n AutoAdjustSubtitle: components.BoolIntTrue.ToPointer(),\n DirectPlay: components.BoolIntTrue.ToPointer(),\n DirectStream: components.BoolIntTrue.ToPointer(),\n DirectStreamAudio: components.BoolIntTrue.ToPointer(),\n DisableResolutionRotation: components.BoolIntTrue.ToPointer(),\n HasMDE: components.BoolIntTrue.ToPointer(),\n Location: operations.QueryParamLocationWan.ToPointer(),\n MediaBufferSize: plexgo.Pointer[int64](102400),\n MediaIndex: plexgo.Pointer[int64](0),\n MusicBitrate: plexgo.Pointer[int64](5000),\n Offset: plexgo.Pointer[float64](90.5),\n PartIndex: plexgo.Pointer[int64](0),\n Path: plexgo.Pointer(\"/library/metadata/151671\"),\n PeakBitrate: plexgo.Pointer[int64](12000),\n PhotoResolution: plexgo.Pointer(\"1080x1080\"),\n Protocol: operations.QueryParamProtocolDash.ToPointer(),\n SecondsPerSegment: plexgo.Pointer[int64](5),\n SubtitleSize: plexgo.Pointer[int64](50),\n VideoBitrate: plexgo.Pointer[int64](12000),\n VideoQuality: plexgo.Pointer[int64](50),\n VideoResolution: plexgo.Pointer(\"1080x1080\"),\n XPlexClientProfileExtra: plexgo.Pointer(\"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)\"),\n XPlexClientProfileName: plexgo.Pointer(\"generic\"),\n })\n if err != nil {\n log.Fatal(err)\n }\n if res != nil {\n // handle response\n }\n}"
- lang: java
label: PlexJava
source: |-
package hello.world;
import dev.plexapi.sdk.PlexAPI;
import dev.plexapi.sdk.models.operations.*;
import dev.plexapi.sdk.models.shared.*;
import java.lang.Exception;
public class Application {
public static void main(String[] args) throws Exception {
PlexAPI sdk = PlexAPI.builder()
.accepts(Accepts.APPLICATION_XML)
.clientIdentifier("abc123")
.product("Plex for Roku")
.version("2.4.1")
.platform("Roku")
.platformVersion("4.3 build 1057")
.device("Roku 3")
.model("4200X")
.deviceVendor("Roku")
.deviceName("Living Room TV")
.marketplace("googlePlay")
.token(System.getenv().getOrDefault("TOKEN", ""))
.build();
TranscodeSubtitlesRequest req = TranscodeSubtitlesRequest.builder()
.transcodeType(TranscodeType.AUDIO)
.advancedSubtitles(AdvancedSubtitles.BURN)
.audioBoost(50L)
.audioChannelCount(5L)
.autoAdjustQuality(BoolInt.True)
.autoAdjustSubtitle(BoolInt.True)
.directPlay(BoolInt.True)
.directStream(BoolInt.True)
.directStreamAudio(BoolInt.True)
.disableResolutionRotation(BoolInt.True)
.hasMDE(BoolInt.True)
.location(QueryParamLocation.WAN)
.mediaBufferSize(102400L)
.mediaIndex(0L)
.musicBitrate(5000L)
.offset(90.5)
.partIndex(0L)
.path("/library/metadata/151671")
.peakBitrate(12000L)
.photoResolution("1080x1080")
.protocol(QueryParamProtocol.DASH)
.secondsPerSegment(5L)
.subtitleSize(50L)
.videoBitrate(12000L)
.videoQuality(50L)
.videoResolution("1080x1080")
.xPlexClientProfileExtra("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("generic")
.build();
TranscodeSubtitlesResponse res = sdk.transcoder().transcodeSubtitles()
.request(req)
.call();
// handle response
}
}
- lang: typescript
label: PlexJS
source: >-
import { PlexAPI } from "@lukehagar/plexjs";
import { TranscodeSubtitlesLocation, TranscodeSubtitlesProtocol }
from "@lukehagar/plexjs/models/operations";
import { Accepts, AdvancedSubtitles, BoolInt, TranscodeType } from
"@lukehagar/plexjs/models/shared";
const plexAPI = new PlexAPI({
accepts: Accepts.ApplicationXml,
clientIdentifier: "abc123",
product: "Plex for Roku",
version: "2.4.1",
platform: "Roku",
platformVersion: "4.3 build 1057",
device: "Roku 3",
model: "4200X",
deviceVendor: "Roku",
deviceName: "Living Room TV",
marketplace: "googlePlay",
token: "",
});
async function run() {
await plexAPI.transcoder.transcodeSubtitles({
transcodeType: TranscodeType.Audio,
advancedSubtitles: AdvancedSubtitles.Burn,
audioBoost: 50,
audioChannelCount: 5,
autoAdjustQuality: BoolInt.True,
autoAdjustSubtitle: BoolInt.True,
directPlay: BoolInt.True,
directStream: BoolInt.True,
directStreamAudio: BoolInt.True,
disableResolutionRotation: BoolInt.True,
hasMDE: BoolInt.True,
location: TranscodeSubtitlesLocation.Wan,
mediaBufferSize: 102400,
mediaIndex: 0,
musicBitrate: 5000,
offset: 90.5,
partIndex: 0,
path: "/library/metadata/151671",
peakBitrate: 12000,
photoResolution: "1080x1080",
protocol: TranscodeSubtitlesProtocol.Dash,
secondsPerSegment: 5,
subtitleSize: 50,
videoBitrate: 12000,
videoQuality: 50,
videoResolution: "1080x1080",
xPlexClientProfileExtra: "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: "generic",
});
}
run();
components:
parameters:
accepts:
name: accepts
description: Indicates the client accepts the indicated media types
in: header
schema:
type: string
default: application/xml
enum:
- application/json
- application/xml
X-Plex-Client-Identifier:
name: X-Plex-Client-Identifier
x-speakeasy-name-override: Client-Identifier
in: header
description: An opaque identifier unique to the client
required: true
schema:
type: string
example: abc123
example: abc123
X-Plex-Product:
name: X-Plex-Product
x-speakeasy-name-override: Product
in: header
description: The name of the client product
schema:
type: string
example: Plex for Roku
example: Plex for Roku
X-Plex-Version:
name: X-Plex-Version
x-speakeasy-name-override: Version
in: header
description: The version of the client application
schema:
type: string
example: 2.4.1
example: 2.4.1
X-Plex-Platform:
name: X-Plex-Platform
x-speakeasy-name-override: Platform
in: header
description: The platform of the client
schema:
type: string
example: Roku
example: Roku
X-Plex-Platform-Version:
name: X-Plex-Platform-Version
x-speakeasy-name-override: Platform-Version
in: header
description: The version of the platform
schema:
type: string
example: 4.3 build 1057
example: 4.3 build 1057
X-Plex-Device:
name: X-Plex-Device
x-speakeasy-name-override: Device
in: header
description: A relatively friendly name for the client device
schema:
type: string
example: Roku 3
example: Roku 3
X-Plex-Model:
name: X-Plex-Model
x-speakeasy-name-override: Model
in: header
description: A potentially less friendly identifier for the device model
schema:
type: string
example: 4200X
example: 4200X
X-Plex-Device-Vendor:
name: X-Plex-Device-Vendor
x-speakeasy-name-override: Device-Vendor
in: header
description: The device vendor
schema:
type: string
example: Roku
example: Roku
X-Plex-Device-Name:
name: X-Plex-Device-Name
x-speakeasy-name-override: Device-Name
in: header
description: A friendly name for the client
schema:
type: string
example: Living Room TV
example: Living Room TV
X-Plex-Marketplace:
name: X-Plex-Marketplace
x-speakeasy-name-override: Marketplace
in: header
description: The marketplace on which the client application is distributed
schema:
type: string
example: googlePlay
example: googlePlay
transcodeType:
name: transcodeType
description: Type of transcode media
in: path
required: true
schema:
type: string
enum:
- video
- music
- audio
- subtitles
transcodeSessionId:
name: transcodeSessionId
description: Transcode session UUID
in: query
schema:
type: string
advancedSubtitles:
name: advancedSubtitles
description: >
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
in: query
schema:
type: string
enum:
- burn
- text
- unknown
example: burn
schemas:
BoolInt:
type: integer
format: int32
enum:
- 0
- 1
example: 1
default: 0
x-speakeasy-enums:
- false
- true
responses:
'400':
description: Bad Request
content:
text/html: {}
'403':
description: Forbidden
content:
text/html: {}
'404':
description: Not Found
content:
text/html: {}
securitySchemes:
token:
name: X-Plex-Token
description: >
The token which identifies the user accessing the PMS. This can be
either:
- A traditional access token obtained from plex.tv
- A JWT token obtained through the JWT authentication flow
JWT tokens provide better security with:
- Short-lived tokens (7 days expiration)
- Public-key cryptography (ED25519)
- Better clock synchronization
- Individual device revocation capability
type: apiKey
in: header
````