_input ¶

Input node.

Functions:

Name	Description
`input`	Input file URL (ffmpeg `-i` option)

input ¶

input(
    filename: str | Path,
    *,
    f: Func = None,
    c: Func = None,
    codec: Func = None,
    t: Func = None,
    to: Func = None,
    ss: Func = None,
    sseof: Func = None,
    seek_timestamp: Func = None,
    accurate_seek: Func = None,
    isync: Func = None,
    itsoffset: Func = None,
    itsscale: Func = None,
    re: Func = None,
    readrate: Func = None,
    bitexact: Func = None,
    tag: Func = None,
    reinit_filter: Func = None,
    dump_attachment: Func = None,
    stream_loop: Func = None,
    discard: Func = None,
    thread_queue_size: Func = None,
    find_stream_info: Func = None,
    r: Func = None,
    s: Func = None,
    pix_fmt: Func = None,
    vn: Func = None,
    vcodec: Func = None,
    top: Func = None,
    vtag: Func = None,
    hwaccel: Func = None,
    hwaccel_device: Func = None,
    hwaccel_output_format: Func = None,
    autorotate: Func = None,
    ar: Func = None,
    ac: Func = None,
    an: Func = None,
    acodec: Func = None,
    sample_fmt: Func = None,
    channel_layout: Func = None,
    ch_layout: Func = None,
    guess_layout_max: Func = None,
    sn: Func = None,
    scodec: Func = None,
    fix_sub_duration: Func = None,
    canvas_size: Func = None,
    bsf: Func = None,
    dcodec: Func = None,
    dn: Func = None,
    decoder_options: FFMpegDecoderOption | None = None,
    demuxer_options: FFMpegDemuxerOption | None = None,
    format_options: (
        FFMpegAVFormatContextDecoderOption | None
    ) = None,
    codec_options: (
        FFMpegAVCodecContextDecoderOption | None
    ) = None,
    extra_options: dict[str, Any] | None = None
) -> AVStream

Input file URL (ffmpeg -i option)

Parameters:

Name	Type	Description	Default
`filename`	`str \| Path`	Input file URL	required
`f`	`Func`	force format	`None`
`c`	`Func`	codec name	`None`
`codec`	`Func`	codec name	`None`
`t`	`Func`	record or transcode "duration" seconds of audio/video	`None`
`to`	`Func`	record or transcode stop time	`None`
`ss`	`Func`	set the start time offset	`None`
`sseof`	`Func`	set the start time offset relative to EOF	`None`
`seek_timestamp`	`Func`	enable/disable seeking by timestamp with -ss	`None`
`accurate_seek`	`Func`	enable/disable accurate seeking with -ss	`None`
`isync`	`Func`	Indicate the input index for sync reference	`None`
`itsoffset`	`Func`	set the input ts offset	`None`
`itsscale`	`Func`	set the input ts scale	`None`
`re`	`Func`	read input at native frame rate; equivalent to -readrate 1	`None`
`readrate`	`Func`	read input at specified rate	`None`
`bitexact`	`Func`	bitexact mode	`None`
`tag`	`Func`	force codec tag/fourcc	`None`
`reinit_filter`	`Func`	reinit filtergraph on input parameter changes	`None`
`dump_attachment`	`Func`	extract an attachment into a file	`None`
`stream_loop`	`Func`	set number of times input stream shall be looped	`None`
`discard`	`Func`	discard	`None`
`thread_queue_size`	`Func`	set the maximum number of queued packets from the demuxer	`None`
`find_stream_info`	`Func`	read and decode the streams to fill missing information with heuristics	`None`
`r`	`Func`	set frame rate (Hz value, fraction or abbreviation)	`None`
`s`	`Func`	set frame size (WxH or abbreviation)	`None`
`pix_fmt`	`Func`	set pixel format	`None`
`vn`	`Func`	disable video	`None`
`vcodec`	`Func`	force video codec ('copy' to copy stream)	`None`
`top`	`Func`	top=1/bottom=0/auto=-1 field first	`None`
`vtag`	`Func`	force video tag/fourcc	`None`
`hwaccel`	`Func`	use HW accelerated decoding	`None`
`hwaccel_device`	`Func`	select a device for HW acceleration	`None`
`hwaccel_output_format`	`Func`	select output format used with HW accelerated decoding	`None`
`autorotate`	`Func`	automatically insert correct rotate filters	`None`
`ar`	`Func`	set audio sampling rate (in Hz)	`None`
`ac`	`Func`	set number of audio channels	`None`
`an`	`Func`	disable audio	`None`
`acodec`	`Func`	force audio codec ('copy' to copy stream)	`None`
`sample_fmt`	`Func`	set sample format	`None`
`channel_layout`	`Func`	set channel layout	`None`
`ch_layout`	`Func`	set channel layout	`None`
`guess_layout_max`	`Func`	set the maximum number of channels to try to guess the channel layout	`None`
`sn`	`Func`	disable subtitle	`None`
`scodec`	`Func`	force subtitle codec ('copy' to copy stream)	`None`
`fix_sub_duration`	`Func`	fix subtitles duration	`None`
`canvas_size`	`Func`	set canvas size (WxH or abbreviation)	`None`
`bsf`	`Func`	A comma-separated list of bitstream filters	`None`
`dcodec`	`Func`	force data codec ('copy' to copy stream)	`None`
`dn`	`Func`	disable data	`None`
`decoder_options`	`FFMpegDecoderOption \| None`	ffmpeg's decoder options	`None`
`demuxer_options`	`FFMpegDemuxerOption \| None`	ffmpeg's demuxer options	`None`
`format_options`	`FFMpegAVFormatContextDecoderOption \| None`	ffmpeg's AVFormatContext options	`None`
`codec_options`	`FFMpegAVCodecContextDecoderOption \| None`	ffmpeg's AVCodecContext options	`None`
`extra_options`	`dict[str, Any] \| None`	ffmpeg's input file options	`None`

Returns:

Type	Description
`AVStream`	Input stream

Examples:

>>> input('input.mp4')
<AVStream:input.mp4:0>