VideoSubtitleTrack

Represents a subtitle track for a video.

Properties

• album_art(Optional[bool]) –

  Whether the track represents album art rather than timed media.

• audio_channels(Optional[int]) –

  Explicit audio channel count override.

• bitrate(Optional[int]) –

  Overall media bitrate in bits per second.

• channels(Optional[str]) –

  Channel layout string describing the spatial arrangement of channels.

• channels_count(Optional[int]) –

  The number of audio channels detected in the media.

• codec(Optional[str]) –

  Codec identifier for the media stream.

• decoder(Optional[str]) –

  Decoder name used to process the media stream.

• fps(Optional[Number]) –

  Video frames per second.

• language(Optional[str]) –

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

• par(Optional[Number]) –

  Pixel aspect ratio value.

• rotate(Optional[int]) –

  Rotation metadata in degrees to apply when rendering the video.

• sample_rate(Optional[int]) –

  Audio sampling rate in hertz.

• src(str) –

  The subtitle source.

• title(Optional[str]) –

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

Methods

• auto –

  Default subtitle track. Selects the first subtitle track.

• none –

  No subtitle track. Disables subtitle output.

Properties

album_art class-attribute instance-attribute

album_art: Optional[bool] = None

Whether the track represents album art rather than timed media.

audio_channels class-attribute instance-attribute

audio_channels: Optional[int] = None

Explicit audio channel count override.

bitrate class-attribute instance-attribute

bitrate: Optional[int] = None

Overall media bitrate in bits per second.

channels class-attribute instance-attribute

channels: Optional[str] = None

Channel layout string describing the spatial arrangement of channels.

channels_count class-attribute instance-attribute

channels_count: Optional[int] = None

The number of audio channels detected in the media.

codec class-attribute instance-attribute

codec: Optional[str] = None

Codec identifier for the media stream.

decoder class-attribute instance-attribute

decoder: Optional[str] = None

Decoder name used to process the media stream.

fps class-attribute instance-attribute

fps: Optional[Number] = None

Video frames per second.

language class-attribute instance-attribute

language: Optional[str] = None

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

par class-attribute instance-attribute

par: Optional[Number] = None

Pixel aspect ratio value.

rotate class-attribute instance-attribute

rotate: Optional[int] = None

Rotation metadata in degrees to apply when rendering the video.

sample_rate class-attribute instance-attribute

sample_rate: Optional[int] = None

Audio sampling rate in hertz.

src instance-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)

title class-attribute instance-attribute

title: Optional[str] = None

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

Methods

auto classmethod

auto() -> VideoSubtitleTrack

Default subtitle track. Selects the first subtitle track.

none classmethod

none() -> VideoSubtitleTrack

No subtitle track. Disables subtitle output.