PySceneDetect

视频切割检测和分析工具

最新版本：v0.6.4（2024年6月10日）

Discord：https://discord.gg/H83HbJngk7

快速安装：

pip install scenedetect[opencv] --upgrade

视频分割支持需要ffmpeg/mkvmerge。Windows版本（MSI安装程序/便携式ZIP）可以在下载页面找到。

快速开始（命令行）：

使用ffmpeg在每个快速切割处分割输入视频：

scenedetect -i video.mp4 split-video

保存每个切割的一些帧：

scenedetect -i video.mp4 save-images

跳过输入视频的前10秒：

scenedetect -i video.mp4 time -s 10s

更多示例可以在文档中找到。

快速开始（Python API）：

要开始使用，库中有一个高级函数可以对视频进行内容感知场景检测（从Python提示符尝试）：

from scenedetect import detect, ContentDetector
scene_list = detect('my_video.mp4', ContentDetector())

scene_list现在将是一个包含视频中找到的所有场景的开始/结束时间的列表。还有一个两遍版本AdaptiveDetector，可以更好地处理快速相机移动，以及ThresholdDetector用于处理淡出/淡入事件。

尝试调用print(scene_list)，或遍历每个场景：

from scenedetect import detect, ContentDetector
scene_list = detect('my_video.mp4', ContentDetector())
for i, scene in enumerate(scene_list):
    print('    场景 %2d: 开始 %s / 帧 %d, 结束 %s / 帧 %d' % (
        i+1,
        scene[0].get_timecode(), scene[0].get_frames(),
        scene[1].get_timecode(), scene[1].get_frames(),))

如果安装了ffmpeg，我们还可以将视频分割成每个场景（也支持mkvmerge）：

from scenedetect import detect, ContentDetector, split_video_ffmpeg
scene_list = detect('my_video.mp4', ContentDetector())
split_video_ffmpeg('my_video.mp4', scene_list)

对于更高级的用法，API高度可配置，可以轻松集成到任何管道中。这包括使用不同的检测算法、分割输入视频等。以下示例展示了如何实现类似上述的函数，但使用scenedetect API：

from scenedetect import open_video, SceneManager, split_video_ffmpeg
from scenedetect.detectors import ContentDetector
from scenedetect.video_splitter import split_video_ffmpeg

def split_video_into_scenes(video_path, threshold=27.0):
    # 打开视频，创建场景管理器，并添加检测器。
    video = open_video(video_path)
    scene_manager = SceneManager()
    scene_manager.add_detector(
        ContentDetector(threshold=threshold))
    scene_manager.detect_scenes(video, show_progress=True)
    scene_list = scene_manager.get_scene_list()
    split_video_ffmpeg(video_path, scene_list, show_progress=True)