,j(' % S SK Jr S SKrS SKrS SKrS SKrS SKJrJrJ r J
r
S SK J r S\
S' \ r " S S5 r " S S
\5 r " S S \5 r " S
S\5 r S SS jjrSSS jjrSS jrg! \ a \R r NYf = f) ) annotationsN)IOAnyMappingSequence)Popenz type[subprocess.Popen | Popen]popenc v \ rS rSrSr S S S jjrS
S jr S S S jjrSrg)
FFmpeg z`Wrapper for various `FFmpeg `_ related applications (ffmpeg,
ffprobe).
Nc 4 Xl U/U l U =R [ USS9-
sl Ub U =R [ USS9-
sl Ub U =R [ U5 -
sl [ R
" U R 5 U l SU l g)a Initialize FFmpeg command line wrapper.
Compiles FFmpeg command line from passed arguments (executable path, options, inputs and
outputs). ``inputs`` and ``outputs`` are dictionares containing inputs/outputs as keys and
their respective options as values. One dictionary value (set of options) must be either a
single space separated string, or a list or strings without spaces (i.e. each part of the
option is a separate item of the list, the result of calling ``split()`` on the options
string). If the value is a list, it cannot be mixed, i.e. cannot contain items with spaces.
An exception are complex FFmpeg command lines that contain quotes: the quoted part must be
one string, even if it contains spaces (see *Examples* for more info).
For more info about FFmpeg command line format see `here
`_.
:param str executable: path to ffmpeg executable; by default the ``ffmpeg`` command will be
searched for in the ``PATH``, but can be overridden with an absolute path to ``ffmpeg``
executable
:param iterable global_options: global options passed to ``ffmpeg`` executable (e.g.
``-y``, ``-v`` etc.); can be specified either as a list/tuple/set of strings, or one
space-separated string; by default no global options are passed
:param dict inputs: a dictionary specifying one or more input arguments as keys with their
corresponding options (either as a list of strings or a single space separated string) as
values
:param dict outputs: a dictionary specifying one or more output arguments as keys with their
corresponding options (either as a list of strings or a single space separated string) as
values
T) split_mixedN)add_minus_i_option)
executable_cmd_normalize_options_merge_args_opts
subprocess list2cmdlinecmdprocess)selfr global_optionsinputsoutputss ڙC:\Users\johnn\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\ffmpy/ffmpy.py__init__FFmpeg.__init__ s| B % L 'DII II)&TJ JI II)'2 2I **49958< c T SU R R < SU R < S3$ )N< >) __class____name__r )r s r __repr__FFmpeg.__repr__F s& 4>>**-Qtxxl!<`_.
:param str input_data: input data for FFmpeg to deal with (audio, video etc.) as bytes (e.g.
the result of reading a file in binary mode)
:param stdout: redirect FFmpeg ``stdout`` there (default is `None` which means no
redirection)
:param stderr: redirect FFmpeg ``stderr`` there (default is `None` which means no
redirection)
:param env: custom environment for ffmpeg process
:param kwargs: any other keyword arguments to be forwarded to `subprocess.Popen
`_
:return: a 2-tuple containing ``stdout`` and ``stderr`` of the process
:rtype: tuple
:raise: `FFRuntimeError` in case FFmpeg command exits with a non-zero code;
`FFExecutableNotFoundError` in case the executable path passed was not valid
)stdinstdoutstderrenvz Executable 'z ' not foundN)inputr )r r r PIPEr OSErrorerrnoENOENTFFExecutableNotFoundErrorr communicate
returncodeFFRuntimeErrorr ) r
input_datar* r+ r, kwargseo_stdouto_stderrs r run
FFmpeg.runI s L !+ TW [a DL "\\ 5 5J 5 G << " "a ' 4<<+B+BHW W!! ww%,,&/,t>O{0[\\ s -B
C 8CC)r r r r )ffmpegNNN)
r strr Sequence[str] | str | Noner /Mapping[str, Sequence[str] | str | None] | Noner r@ returnNone)rA r> )NNNN) r6 z bytes | Noner* IO | int | Noner+ rC r, zMapping[str, str] | Noner7 r rA z!tuple[bytes | None, bytes | None]) r%
__module__ __qualname____firstlineno____doc__r r& r; __static_attributes__ r r r r s #59BFCG ,=,= 3,= @ ,=
A ,=
,=\=
$("&"&(, 4" 4" 4" 4"
& 4"
4"
+4" 4"r r c H ^ \ rS rSrSr S SU 4S jjjrSrU =r$ )FFprobe z=Wrapper for `ffprobe `_.c " > [ TU ] XUS9 g)a Create an instance of FFprobe.
Compiles FFprobe command line from passed arguments (executable path, options, inputs).
FFprobe executable by default is taken from ``PATH`` but can be overridden with an
absolute path. For more info about FFprobe command line format see
`here `_.
:param str executable: absolute path to ffprobe executable
:param iterable global_options: global options passed to ffmpeg executable; can be specified
either as a list/tuple of strings or a space-separated string
:param dict inputs: a dictionary specifying one or more inputs as keys with their
corresponding options as values
)r r r N)superr )r r r r r$ s r r FFprobe.__init__ s & JV\]r rI )ffprobeNN)r r> r r? r r@ rA rB r% rD rE rF rG r rH
__classcell__r$ s @r rK rK sH G $59BF ^^ 3^ @ ^
^ ^r rK c \ rS rSrSrSrg)r2 z3Raise when FFmpeg/FFprobe executable was not found.rI N)r% rD rE rF rG rH rI r r r2 r2 s =r r2 c D ^ \ rS rSrSr SU 4S jjrSrU =r$ )r5 zRaise when FFmpeg/FFprobe command line execution returns a non-zero exit code.
The resulting exception object will contain the attributes relates to command line execution:
``cmd``, ``exit_code``, ``stdout``, ``stderr``.
c > Xl X l X0l X@l [ U5 n[ U5 nSR U R UUU5 n[ TU ] U5 g )Nz2`{}` exited with status {}
STDOUT:
{}
STDERR:
{})r exit_coder* r+ _safe_decodeformatrN r ) r r rY r* r+ stdout_displaystderr_displaymessager$ s r r FFRuntimeError.__init__ s\ " %f-%f-LSS HH
!r )r rY r+ r* )
r r> rY intr* bytes | str | Noner+ ra rA rB rQ rS s @r r5 r5 sB "
" " # "
# "
" "r r5 c / nU R 5 HE u p4U[ U5 -
nU( d M U( a UR S5 UR U5 MG U$ )a Merge options with their corresponding arguments.
Iterates over the dictionary holding arguments (keys) and options (values). Merges each
options string with its corresponding argument.
:param dict args_opts_dict: a dictionary of arguments and options
:param dict kwargs: *input_option* - if specified prepends ``-i`` to input argument
:return: merged list of strings with arguments and their corresponding options
:rtype: list
z-i)itemsr append)args_opts_dictr mergedargopts r r r sV F"((*$S)) MM$
c + Mr c
U c / $ [ U [ 5 ( a [ R " U 5 $ U( aA [ [
R " U Vs/ s H n[ R " U5 PM sn6 5 $ [ U 5 $ s snf )aJ Normalize options string or list of strings.
Splits `options` into a list of strings. If `split_mixed` is `True`, splits (flattens) mixed
options (i.e. list of strings with spaces) into separate items.
:param options: options string or list of strings
:param bool split_mixed: whether to split mixed options into separate items
)
isinstancer> shlexsplitlist itertoolschain)optionsr os r r r sh GS ! !{{7## ')J'Q%++a.')JKL L= *Ks B c V U c g[ U [ 5 ( a U R SS9$ U $ )z1Convert FFmpeg output to text for error messages. replace)errors)rj bytesdecode) stream_datas r rZ rZ s2 +u%%!!!33 r )F)re z(Mapping[str, Sequence[str] | str | None]r boolrA list[str])rp r? r ry rA rz )rx ra rA r> )
__future__r r0 rn rk r typingr r r r psutilr __annotations__r ImportErrorr rK Exceptionr2 r5 r r rZ rI r r r s " - - ))
Ej" j"Z^f ^2> > "Y "D %< <!(E E s A7 7B B