Skip to main content

class  pixeltable.functions.StreamMetadata

Metadata for a stream within a media container.

attr  average_rate

average_rate: float | None
Average frame rate in FPS (frames per second). Present only for video streams.

attr  base_rate

base_rate: float | None
Base (constant) frame rate in FPS. Present only for video streams.

attr  codec_context

codec_context: CodecContextMetadata
Codec information for this stream.

attr  duration

duration: int | None
Stream duration in time_base units, or None if unknown.

attr  duration_seconds

duration_seconds: float | None
Stream duration in seconds, computed from duration and time_base.

attr  frames

frames: int
Number of frames in the stream (may be 0 if unknown).

attr  guessed_rate

guessed_rate: float | None
Guessed frame rate in FPS. Present only for video streams.

attr  height

height: int
Frame height in pixels. Present only for video streams.

attr  metadata

metadata: dict[str, str]
Additional stream-specific metadata tags (e.g. language, title).

attr  time_base

time_base: float | None
Time base of the stream as a float (seconds per tick), or None if unknown.

attr  type

type: str
Stream type: typically 'audio' or 'video'. Other stream types (e.g. subtitles) will have a StreamMetadata entry, but with no metadata other than type.

attr  width

width: int
Frame width in pixels. Present only for video streams.
Last modified on June 3, 2026