VideoSubtitleTrack

Represents a subtitle track for a video.

Properties

• album_art - Whether the track represents album art rather than timed media.
• audio_channels - Explicit audio channel count override.
• bitrate - Overall media bitrate in bits per second.
• channels - Channel layout string describing the spatial arrangement of channels.
• channels_count - The number of audio channels detected in the media.
• codec - Codec identifier for the media stream.
• decoder - Decoder name used to process the media stream.
• fps - Video frames per second.
• language - The language of the subtitle track, e.g.
• par - Pixel aspect ratio value.
• rotate - Rotation metadata in degrees to apply when rendering the video.
• sample_rate - Audio sampling rate in hertz.
• src - The subtitle source.
• title - The title of the subtitle track, e.g.

Methods

• auto - Default subtitle track.
• none - No subtitle track.

Properties

buildalbum_artclass-attributeinstance-attribute

album_art: Optional[bool] = None

Whether the track represents album art rather than timed media.

buildaudio_channelsclass-attributeinstance-attribute

audio_channels: Optional[int] = None

Explicit audio channel count override.

buildbitrateclass-attributeinstance-attribute

bitrate: Optional[int] = None

Overall media bitrate in bits per second.

buildchannelsclass-attributeinstance-attribute

channels: Optional[str] = None

Channel layout string describing the spatial arrangement of channels.

buildchannels_countclass-attributeinstance-attribute

channels_count: Optional[int] = None

The number of audio channels detected in the media.

buildcodecclass-attributeinstance-attribute

codec: Optional[str] = None

Codec identifier for the media stream.

builddecoderclass-attributeinstance-attribute

decoder: Optional[str] = None

Decoder name used to process the media stream.

buildfpsclass-attributeinstance-attribute

fps: Optional[Number] = None

Video frames per second.

buildlanguageclass-attributeinstance-attribute

language: Optional[str] = None

The language of the subtitle track, e.g. 'en'.

buildparclass-attributeinstance-attribute

par: Optional[Number] = None

Pixel aspect ratio value.

buildrotateclass-attributeinstance-attribute

rotate: Optional[int] = None

Rotation metadata in degrees to apply when rendering the video.

buildsample_rateclass-attributeinstance-attribute

sample_rate: Optional[int] = None

Audio sampling rate in hertz.

buildsrcinstance-attribute

src: str

The subtitle source.

Supported values:

• A URL (e.g. "https://example.com/subs.srt" or "www.example.com/sub.vtt")
• An absolute local file path (not supported on the web platform)
• A raw subtitle text string (e.g. the full contents of an SRT/VTT file)

buildtitleclass-attributeinstance-attribute

title: Optional[str] = None

The title of the subtitle track, e.g. 'English'.

Methods

deployed_codeautoclassmethod

auto(cls)

Default subtitle track. Selects the first subtitle track.

deployed_codenoneclassmethod

none(cls)

No subtitle track. Disables subtitle output.