Currently, this page contains the output of running PySceneDetect with the --help flag. In the future, it will contain expanded definitions and inline examples for those options in the output below.
usage: scenedetect.py [-h] [-v] -i VIDEO_FILE [-o SCENE_LIST] [-t intensity]
[-m num_frames] [-p percent] [-b rows] [-s STATS_FILE]
[-d detection_method] [-l] [-q] [-st time] [-dt time]
[-et time] [-df factor] [-fs num_frames] [-si]
arguments:
-h, --help show this help message and exit
-v, --version show version number and license/copyright information
-i VIDEO_FILE, --input VIDEO_FILE
[REQUIRED] Path to input video. (default: None)
-o SCENE_LIST, --output SCENE_LIST
File to store detected scenes in using the specified
timecodeformat as comma-separated values (.csv). File
will be overwritten if already exists. (default: None)
-t intensity, --threshold intensity
8-bit intensity value, from 0-255, to use as the black
level in threshold detection mode, or as the change
tolerance threshold in content-aware detection mode.
(default: 12)
-m num_frames, --min-scene-length num_frames
Minimum length, in frames, before another scene cut
can be generated. (default: 15)
-p percent, --min-percent percent
Amount of pixels in a frame, from 0-100%, that must
fall under [intensity]. Only applies to threshold
detection. (default: 95)
-b rows, --block-size rows
Number of rows in frame to check at once, can be tuned
for performance. Only applies to threshold detection.
(default: 32)
-s STATS_FILE, --statsfile STATS_FILE
File to store video statistics data, comma-separated
value format (.csv). Will be overwritten if exists.
(default: None)
-d detection_method, --detector detection_method
Type of scene detection method/algorithm to use;
detectors available: [threshold, content]. (default:
threshold)
-l, --list-scenes Output the final scene list in human-readable format
as a table, in addition to CSV. (default: False)
-q, --quiet Suppress all output except for final comma-separated
list of scene cuts. Useful for computing or piping
output directly into other programs/scripts. (default:
False)
-st time, --start-time time
Time to seek to in video before performing detection.
Can be given in number of frames (12345), seconds
(number followed by s, e.g. 123s or 123.45s), or
timecode (HH:MM:SS[.nnn]). (default: None)
-dt time, --duration time
Time to limit scene detection to (see -st for time
format). Overrides -et. (default: None)
-et time, --end-time time
Time to stop scene detection at (see -st for time
format). (default: None)
-df factor, --downscale-factor factor
Factor to downscale (shrink) image before processing,
to improve performance. For example, if input video
resolution is 1024 x 400, and factor = 2, each frame
is reduced to 1024/2 x 400/2 = 512 x 200 before
processing. (default: 1)
-fs num_frames, --frame-skip num_frames
Number of frames to skip after processing a given
frame. Improves performance at expense of frame
accuracy, and may increase probability of inaccurate
scene cut prediction. If required, values above 1 or 2
are not recommended. (default: 0)
-si, --save-images If set, the first and last frames in each detected
scene will be saved to disk. Images will saved in the
current working directory, using the same filename as
the input but with the scene and frame numbers
appended. (default: False)