Overview

docs
tests
package

Cut and join CLI wrapper for ffmpeg.

• Free software: BSD 2-Clause License

Installation

pip install ffmpeg-cut

You can also install the in-development version with:

pip install https://github.com/ionelmc/python-ffmpeg-cut/archive/main.zip

Documentation

https://python-ffmpeg-cut.readthedocs.io/

Usage: ffmpeg-cut [-h] [[-j | -c W:H | -f W:H |] -n] [-q CRF] [-d] [-r] [-s FPS] [-e ENCODER] [-t] [-l] input output [cut] [cut ...]

positional arguments:

input

input file

output

output file

cut

pair of timestamps to cut

options:

-h, --help	show this help message and exit
-j, --join	input file is ffmpeg concat instruction file
-c SIZE, --crop SIZE
	crop input to a given ratio
-f SIZE, --filter SIZE
	arbitrary filter on specific zone
-n, --no-join	only produce the intermediary clips and ffmpeg concat instruction file
-q CRF, --quality CRF
	libx265 crf
-d, --dry-run	only display what would be run
-r, --dirty	do not delete intermediary files
-s FPS, --fps FPS
	output framerate
-e ENCODER, --encoder ENCODER
	you can use libx265 for better compression but possibly worse player support
-t, --text	input file is text file with cuts
-l, --clips	input file is clips file with cuts

If you use --text then the input file must contain instructions in the form:

path/to/video.mkv
HH:MM:SS.mmm-HH:MM:SS.mmm
HH:MM:SS.mmm-HH:MM:SS.mmm

path/to/another/video.mp4
HH:MM:SS.mmm-HH:MM:SS.mmm
HH:MM:SS.mmm-HH:MM:SS.mmm
HH:MM:SS.mmm-HH:MM:SS.mmm

Development

To run all the tests run:

tox

Note, to combine the coverage data from all the tox environments run:

Windows	set PYTEST_ADDOPTS=--cov-append tox
Other	PYTEST_ADDOPTS=--cov-append tox