Breakthrough/PySceneDetect

これは何？

主な機能

• 01コンテンツ認識型検出と適応型検出により、ハードカットを検出します。
• 02しきい値検出により、黒へのフェードイン・フェードアウトを検出します。
• 03ffmpegまたはmkvmergeを使って、動画をシーンごとのクリップに分割します。
• 04検出した各シーンのフレームを画像として保存します。
• 05コマンドラインインターフェースとPython APIの両方を提供します。
• 06PyPI、Docker、Windowsインストーラー経由で配布されています。

ユースケース

• 長時間の映像や映画を、編集・確認用に個々のショットへ分割する。
• 動画機械学習用に、ショットやキーフレームのデータセットを作成する。
• 各シーンからサムネイルやプレビューを自動生成する。
• 動画処理パイプラインにシーン検出を組み込む。

クイックスタート

1. 1

   PyPIからパッケージをインストールする

   pip install scenedetect --upgrade
2. 2

   シーンを検出し、カットごとにffmpegで動画を分割する

   scenedetect -i video.mp4 split-video

使う前に知っておきたいこと

• !Dockerイメージを使用する場合を除き、動画の分割にはffmpegまたはmkvmergeを別途インストールする必要があります。

収録されている特集

トピック

よくある質問

PySceneDetect とは？

動画内のシーンカットやトランジションを検出し、必要に応じてクリップに分割できるPython・OpenCV製のツール／ライブラリ。 PySceneDetectは動画ファイルを解析し、あるショットが終わって次のショットが始まる位置を検出します。コマンドラインプログラムとPython APIを備えています。検出方式には、素早いカット向けのコンテンツ認識型検出、カメラの素早い動きに対応する適応型検出、黒へのフェードイン・フェードアウト向けのしきい値検出があります。

PySceneDetect は無料で使えますか？ライセンスは？

PySceneDetect は BSD-3-Clause ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

PySceneDetect は今もメンテナンスされていますか？

活発にメンテナンス中。PySceneDetect の最終コミットは 2026年11月2日 です。

PySceneDetect は何に使えますか？

長時間の映像や映画を、編集・確認用に個々のショットへ分割する。 動画機械学習用に、ショットやキーフレームのデータセットを作成する。 各シーンからサムネイルやプレビューを自動生成する。 動画処理パイプラインにシーン検出を組み込む。

PySceneDetect のインストール方法は？

PyPIからパッケージをインストールする: pip install scenedetect --upgrade シーンを検出し、カットごとにffmpegで動画を分割する: scenedetect -i video.mp4 split-video

PySceneDetect はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/Breakthrough/PySceneDetect