File Transcode Options

Configuration options for the shared file-based GStreamer transcode recipe.

`FileTranscodeOptions(name='transcoder', preserve_fps=False, target_fps=None, seek=None, video_mode='encode', audio_mode='passthrough', sample_rate=None, channels=None, muxer_name=None)` `dataclass`

Options for BaseGstreamerProcessor._run_file_transcode.

Attributes:

Name	Type	Description
`name`	`str`	GStreamer pipeline name. Defaults to `"transcoder"`.
`preserve_fps`	`bool`	Keep the source frame rate when re-encoding video. Defaults to `False`.
`target_fps`	`int \| None`	Target frame rate when `preserve_fps` is `False`. Defaults to `None`.
`seek`	`tuple[float, float] \| None`	Optional `(start, end)` window in seconds for accurate clipping. Defaults to `None`.
`video_mode`	`VideoMode`	`"encode"` wires a video branch; `"drop"` sends video pads to `fakesink`. Defaults to `"encode"`.
`audio_mode`	`AudioMode`	How decodebin audio pads are handled. Defaults to `"passthrough"`.
`sample_rate`	`int \| None`	Force output sample rate for `extract` mode. Defaults to `None`.
`channels`	`int \| None`	Force output channel count for `extract` mode. Defaults to `None`.
`muxer_name`	`str \| None`	Override muxer element for `extract` mode. Defaults to `None`.