scenedetect 0.7__tar.gz → 0.7.1.dev0__tar.gz

{scenedetect-0.7/scenedetect.egg-info → scenedetect-0.7.1.dev0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: scenedetect
-Version: 0.7
-Summary: Video scene cut/shot detection program and Python library.
+Version: 0.7.1.dev0
+Summary: Video scene cut/shot detection program and Python library (bundles the opencv-python OpenCV variant and the scenedetect CLI).
 Author-email: Brandon Castellano <brandon248@gmail.com>
 License-Expression: BSD-3-Clause
 Project-URL: Homepage, https://www.scenedetect.com
@@ -37,16 +37,6 @@ Provides-Extra: pyav
 Requires-Dist: av>=9.2; extra == "pyav"
 Provides-Extra: moviepy
 Requires-Dist: moviepy; extra == "moviepy"
-Provides-Extra: dev
-Requires-Dist: av>=9.2; extra == "dev"
-Requires-Dist: moviepy; extra == "dev"
-Requires-Dist: pytest>=7.0; extra == "dev"
-Provides-Extra: docs
-Requires-Dist: Sphinx==7.0.1; extra == "docs"
-Requires-Dist: sphinx-copybutton==0.5.2; extra == "docs"
-Provides-Extra: website
-Requires-Dist: mkdocs==1.5.2; extra == "website"
-Requires-Dist: jinja2>=3.1.6; extra == "website"
 Dynamic: license-file
 
 
@@ -76,6 +66,8 @@ Github Repo: https://github.com/Breakthrough/PySceneDetect/
 
 Install: ``pip install --upgrade scenedetect`` (or ``scenedetect-headless`` for servers)
 
+Packages: `scenedetect <https://pypi.org/project/scenedetect/>`_ (CLI + ``opencv-python``), `scenedetect-headless <https://pypi.org/project/scenedetect-headless/>`_ (CLI + ``opencv-python-headless``), and `scenedetect-core <https://pypi.org/project/scenedetect-core/>`_ (library only, minimal dependencies, bring your own OpenCV variant). All provide the same ``scenedetect`` module -- install only one.
+
 ----------------------------------------------------------
 
 **PySceneDetect** is a tool for detecting shot changes in videos, and can automatically split videos into separate clips.  PySceneDetect is free and open-source software, and has several detection methods to find fast-cuts and threshold-based fades.

{scenedetect-0.7 → scenedetect-0.7.1.dev0}/README.md

@@ -1,8 +1,10 @@
 
-![PySceneDetect](https://raw.githubusercontent.com/Breakthrough/PySceneDetect/main/website/pages/img/pyscenedetect_logo_small.png)
-==========================================================
-Video Cut Detection and Analysis Tool
-----------------------------------------------------------
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Breakthrough/PySceneDetect/main/website/pages/img/pyscenedetect_logo_small_darkmode.png">
+  <img alt="PySceneDetect" src="https://raw.githubusercontent.com/Breakthrough/PySceneDetect/main/website/pages/img/pyscenedetect_logo_small.png">
+</picture>
+
+# Video Cut Detection and Analysis Tool
 
 [![Build Status](https://img.shields.io/github/actions/workflow/status/Breakthrough/PySceneDetect/build.yml)](https://github.com/Breakthrough/PySceneDetect/actions)
 [![PyPI Status](https://img.shields.io/pypi/status/scenedetect.svg)](https://pypi.python.org/pypi/scenedetect/)
@@ -25,8 +27,7 @@ Video Cut Detection and Analysis Tool
 
 **Quick Install**:
 
-    pip install scenedetect --upgrade           # standard (depends on opencv-python)
-    pip install scenedetect-headless --upgrade  # headless servers (depends on opencv-python-headless)
+    pip install scenedetect --upgrade
 
 Requires ffmpeg/mkvmerge for video splitting support. Windows builds (MSI installer/portable ZIP) can be found on [the download page](https://scenedetect.com/download/).
 
@@ -114,7 +115,7 @@ We evaluate the performance of different detectors in terms of accuracy and proc
 Please submit any bugs/issues or feature requests to [the Issue Tracker](https://github.com/Breakthrough/PySceneDetect/issues). Before submission, ensure you search through existing issues (both open and closed) to avoid creating duplicate entries.
 Pull requests are welcome and encouraged.  PySceneDetect is released under the BSD 3-Clause license, and submitted code should be compliant.
 
-For help or other issues, you can join [the official PySceneDetect Discord Server](https://discord.gg/H83HbJngk7), submit an issue/bug report [here on Github](https://github.com/Breakthrough/PySceneDetect/issues), or contact me via [my website](http://www.bcastell.com/about/).
+For help or other issues, you can join [the official PySceneDetect Discord Server](https://discord.gg/H83HbJngk7), submit an issue/bug report [here on Github](https://github.com/Breakthrough/PySceneDetect/issues), or contact me via [my website](https://bcastell.com/about/).
 
 ## Code Signing
 

{scenedetect-0.7 → scenedetect-0.7.1.dev0}/docs/api/backends.rst

@@ -1,9 +1,9 @@
 
 .. _scenedetect-backends:
 
-----------------------------------------
+--------------
 Video Backends
-----------------------------------------
+--------------
 
 .. automodule:: scenedetect.backends
    :members:
@@ -16,3 +16,6 @@ Video Backends
 
 .. automodule:: scenedetect.backends.moviepy
    :members:
+
+.. automodule:: scenedetect.backends.concat
+   :members:

scenedetect-0.7.1.dev0/docs/api/common.rst

@@ -0,0 +1,9 @@
+
+.. _scenedetect-common:
+
+------
+Common
+------
+
+.. automodule:: scenedetect.common
+   :members:

scenedetect-0.7.1.dev0/docs/api/detector.rst

@@ -0,0 +1,9 @@
+
+.. _scenedetect-detector:
+
+------------------
+Detector Interface
+------------------
+
+.. automodule:: scenedetect.detector
+   :members:

scenedetect-0.7.1.dev0/docs/api/detectors.rst

@@ -0,0 +1,53 @@
+
+.. _scenedetect-detectors:
+
+---------
+Detectors
+---------
+
+.. automodule:: scenedetect.detectors
+
+AdaptiveDetector
+================
+
+.. automodule:: scenedetect.detectors.adaptive_detector
+   :no-members:
+
+.. autoclass:: scenedetect.detectors.adaptive_detector.AdaptiveDetector
+   :members:
+
+ContentDetector
+===============
+
+.. automodule:: scenedetect.detectors.content_detector
+   :no-members:
+
+.. autoclass:: scenedetect.detectors.content_detector.ContentDetector
+   :members:
+
+HashDetector
+============
+
+.. automodule:: scenedetect.detectors.hash_detector
+   :no-members:
+
+.. autoclass:: scenedetect.detectors.hash_detector.HashDetector
+   :members:
+
+HistogramDetector
+=================
+
+.. automodule:: scenedetect.detectors.histogram_detector
+   :no-members:
+
+.. autoclass:: scenedetect.detectors.histogram_detector.HistogramDetector
+   :members:
+
+ThresholdDetector
+=================
+
+.. automodule:: scenedetect.detectors.threshold_detector
+   :no-members:
+
+.. autoclass:: scenedetect.detectors.threshold_detector.ThresholdDetector
+   :members:

{scenedetect-0.7 → scenedetect-0.7.1.dev0}/docs/api/migration_guide.rst

@@ -2,7 +2,7 @@
 .. _scenedetect-migration-guide:
 
 ***********************************************************************
-Migration Guide: v0.6 to v0.7
+Migration Guide (v0.7)
 ***********************************************************************
 
 PySceneDetect v0.7 is a major release that overhauls timestamp handling to support variable framerate (VFR) videos. While the high-level :func:`scenedetect.detect` workflow is largely unchanged, several internal APIs have been restructured. This guide covers the changes needed to update applications from v0.6 to v0.7.

scenedetect-0.7.1.dev0/docs/api/output.rst

@@ -0,0 +1,9 @@
+
+.. _scenedetect-output:
+
+------
+Output
+------
+
+.. automodule:: scenedetect.output
+   :members:

scenedetect-0.7.1.dev0/docs/api/platform.rst

@@ -0,0 +1,9 @@
+
+.. _scenedetect-platform:
+
+------------------
+Platform & Logging
+------------------
+
+.. automodule:: scenedetect.platform
+   :members:

scenedetect-0.7.1.dev0/docs/api/scene_manager.rst

@@ -0,0 +1,9 @@
+
+.. _scenedetect-scene_manager:
+
+-------------
+Scene Manager
+-------------
+
+.. automodule:: scenedetect.scene_manager
+   :members:

scenedetect-0.7.1.dev0/docs/api/stats_manager.rst

@@ -0,0 +1,9 @@
+
+.. _scenedetect-stats_manager:
+
+-------------
+Stats Manager
+-------------
+
+.. automodule:: scenedetect.stats_manager
+   :members:

scenedetect-0.7.1.dev0/docs/api/video_stream.rst

@@ -0,0 +1,9 @@
+
+.. _scenedetect-video_stream:
+
+----------------
+Stream Interface
+----------------
+
+.. automodule:: scenedetect.video_stream
+   :members:

{scenedetect-0.7 → scenedetect-0.7.1.dev0}/docs/api.rst

@@ -9,15 +9,15 @@ The `scenedetect` API is easy to integrate with most application workflows, whil
 
     * :ref:`scenedetect.detectors 🕵️ <scenedetect-detectors>`: detection algorithms:
 
-        * :mod:`AdaptiveDetector <scenedetect.detectors.adaptive_detector>` finds fast cuts using rolling average of HSL changes
+        * :class:`AdaptiveDetector <scenedetect.detectors.adaptive_detector.AdaptiveDetector>`: finds fast cuts using rolling average of HSL changes
 
-        * :mod:`ContentDetector <scenedetect.detectors.content_detector>`: detects fast cuts using weighted average of HSV changes
+        * :class:`ContentDetector <scenedetect.detectors.content_detector.ContentDetector>`: detects fast cuts using weighted average of HSV changes
 
-        * :mod:`ThresholdDetector <scenedetect.detectors.threshold_detector>`: finds fades in/out using average pixel intensity changes in RGB
+        * :class:`ThresholdDetector <scenedetect.detectors.threshold_detector.ThresholdDetector>`: finds fades in/out using average pixel intensity changes in RGB
 
-        * :mod:`HistogramDetector <scenedetect.detectors.histogram_detector>` finds fast cuts using HSV histogram changes
+        * :class:`HistogramDetector <scenedetect.detectors.histogram_detector.HistogramDetector>`: finds fast cuts using HSV histogram changes
 
-        * :mod:`HashDetector <scenedetect.detectors.hash_detector>`: finds fast cuts using perceptual image hashing
+        * :class:`HashDetector <scenedetect.detectors.hash_detector.HashDetector>`: finds fast cuts using perceptual image hashing
 
     * :ref:`scenedetect.output ✂️ <scenedetect-output>`: Output formats:
 
@@ -29,19 +29,21 @@ The `scenedetect` API is easy to integrate with most application workflows, whil
 
     * :ref:`scenedetect.backends 🎥 <scenedetect-backends>`: PySceneDetect supports multiple libraries as an input backend:
 
-        * OpenCV: :class:`VideoStreamCv2 <scenedetect.backends.opencv.ideoStreamCv2>`
+        * OpenCV: :class:`VideoStreamCv2 <scenedetect.backends.opencv.VideoStreamCv2>`
 
         * PyAV: :class:`VideoStreamAv <scenedetect.backends.pyav.VideoStreamAv>`
 
         * MoviePy: :class:`VideoStreamMoviePy <scenedetect.backends.moviepy.VideoStreamMoviePy>`
 
+        * Multiple videos can be treated as a single continuous stream using :class:`VideoStreamConcat <scenedetect.backends.concat.VideoStreamConcat>` (e.g. ``open_video(["part1.mp4", "part2.mp4"])``)
+
     * :ref:`scenedetect.common ⏱️ <scenedetect-common>`: common functionality such as :class:`FrameTimecode <scenedetect.common.FrameTimecode>` for timecode handling
 
     * :ref:`scenedetect.scene_manager 🎞️ <scenedetect-scene_manager>`: the :class:`SceneManager <scenedetect.scene_manager.SceneManager>` coordinates performing scene detection on a video with one or more detectors
 
     * :ref:`scenedetect.detector 🌐 <scenedetect-detector>`: the interface (:class:`SceneDetector <scenedetect.detector.SceneDetector>`) that detectors must implement to be compatible with PySceneDetect
 
-    * :ref:`scenedetect.video_stream  <scenedetect-video_stream>`: the interface (:class:`VideoStream <scenedetect.video_stream.VideoStream>`) that detectors must implement to be compatible with PySceneDetect
+    * :ref:`scenedetect.video_stream 📹 <scenedetect-video_stream>`: the interface (:class:`VideoStream <scenedetect.video_stream.VideoStream>`) that video backends must implement to be compatible with PySceneDetect
 
     * :ref:`scenedetect.stats_manager 🧮 <scenedetect-stats_manager>`: the :class:`StatsManager <scenedetect.stats_manager.StatsManager>` allows you to store detection metrics for each frame and save them to CSV for further analysis
 
@@ -96,23 +98,6 @@ Functions
 .. automodule:: scenedetect
     :members:
 
-.. toctree::
-    :maxdepth: 3
-    :caption: PySceneDetect Module Documentation
-    :name: fullapitoc
-    :hidden:
-
-    api/migration_guide
-    api/detectors
-    api/scene_manager
-    api/common
-    api/output
-    api/backends
-    api/stats_manager
-    api/detector
-    api/video_stream
-    api/platform
-
 
 =======================================================================
 Logging

{scenedetect-0.7 → scenedetect-0.7.1.dev0}/docs/cli.rst

@@ -857,6 +857,10 @@ Options
 
   Split video using mkvmerge. Faster than re-encoding, but less precise. If set, options other than :option:`-f/--filename <-f>`, :option:`-q/--quiet <-q>` and :option:`-o/--output <-o>` will be ignored. Note that mkvmerge automatically appends the $SCENE_NUMBER suffix.
 
+.. option:: --expand
+
+  Extend the first/last output clips to cover the full input video, even if the :ref:`time <command-time>` command's ``--start``/``--end`` limited the analysis window. Useful for keeping content outside the analyzed region attached to the adjacent split.
+
 
 .. _command-time:
 

{scenedetect-0.7 → scenedetect-0.7.1.dev0}/docs/conf.py

@@ -45,6 +45,9 @@ autodoc_member_order = "groupwise"
 autodoc_typehints = "description"
 autodoc_typehints_format = "short"
 
+add_module_names = False
+python_use_unqualified_type_names = True
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
 

{scenedetect-0.7 → scenedetect-0.7.1.dev0}/docs/index.rst

@@ -8,7 +8,7 @@ PySceneDetect Documentation
 
 Welcome to the PySceneDetect docs. The docs are split into two separate parts: one for the command-line interface (the `scenedetect` command) and another for the Python API (the `scenedetect` module).
 
-You can install the latest release of PySceneDetect by running `pip install scenedetect` (or `pip install scenedetect-headless` on servers without GUI libraries), or by downloading the Windows build from `scenedetect.com/download <http://www.scenedetect.com/download/>`_. PySceneDetect requires `ffmpeg` or `mkvmerge` for video splitting support.
+You can install the latest release of PySceneDetect by running `pip install scenedetect` (or `pip install scenedetect-headless` on servers without GUI libraries), or by downloading the Windows build from `scenedetect.com/download <http://www.scenedetect.com/download/>`_. Library-only installs that need a specific OpenCV variant (e.g. `opencv-contrib-python`) can use `pip install scenedetect-core`, which has no CLI dependencies and lets you supply any OpenCV package. PySceneDetect requires `ffmpeg` or `mkvmerge` for video splitting support.
 
 .. note::
 
@@ -54,6 +54,7 @@ Table of Contents
     api/video_stream
     api/stats_manager
     api/platform
+    api/migration_guide
 
 =======================================================================
 Indices and Tables

{scenedetect-0.7 → scenedetect-0.7.1.dev0}/packaging/package-info.rst

@@ -25,6 +25,8 @@ Github Repo: https://github.com/Breakthrough/PySceneDetect/
 
 Install: ``pip install --upgrade scenedetect`` (or ``scenedetect-headless`` for servers)
 
+Packages: `scenedetect <https://pypi.org/project/scenedetect/>`_ (CLI + ``opencv-python``), `scenedetect-headless <https://pypi.org/project/scenedetect-headless/>`_ (CLI + ``opencv-python-headless``), and `scenedetect-core <https://pypi.org/project/scenedetect-core/>`_ (library only, minimal dependencies, bring your own OpenCV variant). All provide the same ``scenedetect`` module -- install only one.
+
 ----------------------------------------------------------
 
 **PySceneDetect** is a tool for detecting shot changes in videos, and can automatically split videos into separate clips.  PySceneDetect is free and open-source software, and has several detection methods to find fast-cuts and threshold-based fades.

scenedetect-0.7.1.dev0/pyproject.toml

@@ -0,0 +1,81 @@
+#
+#         PySceneDetect: Python-Based Video Scene Detector
+#   ---------------------------------------------------------------
+#     [  Site: http://www.bcastell.com/projects/PySceneDetect/   ]
+#     [  Github: https://github.com/Breakthrough/PySceneDetect/  ]
+#     [  Documentation: http://www.scenedetect.com/docs/         ]
+#
+# Copyright (C) 2014 Brandon Castellano <http://www.bcastell.com>.
+#
+# pyproject.toml for the `scenedetect` package: the same code as scenedetect-core,
+# but bundling the opencv-python (GUI-capable) OpenCV variant, the CLI dependencies,
+# and the `scenedetect` console script. packaging/build_all.py temporarily swaps
+# this file into the repo root and builds from there, so the code, readme, and
+# dynamic version are shared with the other variants.
+#
+# Keep [project] metadata (classifiers, requires-python, etc.) in sync with the
+# root pyproject.toml and pyproject-scenedetect-headless.toml. Only the name,
+# description, dependencies, extras, and console script differ between variants.
+
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "scenedetect"
+dynamic = ["version"]
+description = "Video scene cut/shot detection program and Python library (bundles the opencv-python OpenCV variant and the scenedetect CLI)."
+readme = { file = "packaging/package-info.rst", content-type = "text/x-rst" }
+license = "BSD-3-Clause"
+license-files = ["LICENSE"]
+requires-python = ">=3.10"
+authors = [{ name = "Brandon Castellano", email = "brandon248@gmail.com" }]
+keywords = ["video", "computer-vision", "analysis"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Environment :: Console :: Curses",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "Intended Audience :: System Administrators",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Video",
+    "Topic :: Multimedia :: Video :: Conversion",
+    "Topic :: Multimedia :: Video :: Non-Linear Editor",
+    "Topic :: Utilities",
+]
+dependencies = [
+    # click 8.3.0 specifically is excluded per https://scenedetect.com/issues/521; 8.3.1+ are fine.
+    "click~=8.0,!=8.3.0",
+    "numpy",
+    "opencv-python",
+    "platformdirs",
+    "tqdm",
+]
+
+[project.optional-dependencies]
+pyav = ["av>=9.2"]
+moviepy = ["moviepy"]
+
+[project.urls]
+Homepage = "https://www.scenedetect.com"
+Documentation = "https://www.scenedetect.com/docs/"
+Source = "https://github.com/Breakthrough/PySceneDetect"
+Issues = "https://github.com/Breakthrough/PySceneDetect/issues"
+
+[project.scripts]
+scenedetect = "scenedetect.__main__:main"
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+include = ["scenedetect*"]
+
+[tool.setuptools.dynamic]
+version = { attr = "scenedetect.__version__" }

{scenedetect-0.7 → scenedetect-0.7.1.dev0}/scenedetect/__init__.py

@@ -69,20 +69,22 @@ from scenedetect.backends import (
     VideoStreamAv,
     VideoStreamMoviePy,
     VideoCaptureAdapter,
+    VideoStreamConcat,
+    SourceSpan,
 )
 from scenedetect.stats_manager import StatsManager, StatsFileCorrupt
 from scenedetect.scene_manager import SceneManager
 
 # Used for module identification and when printing version & about info
 # (e.g. calling `scenedetect version` or `scenedetect about`).
-__version__ = "0.7"
+__version__ = "0.7.1-dev0"
 
 init_logger()
 logger = getLogger("pyscenedetect")
 
 
 def open_video(
-    path: StrPath,
+    path: "StrPath | list[StrPath] | tuple[StrPath, ...]",
     frame_rate: FrameRate | None = None,
     backend: str = "opencv",
     framerate: float | None = None,
@@ -92,7 +94,9 @@ def open_video(
     system, OpenCV (`VideoStreamCv2`) will be used as a fallback.
 
     Arguments:
-        path: Path to video file to open.
+        path: Path to video file to open. May also be a list of paths, in which case the videos
+            are concatenated and treated as a single continuous stream
+            (see :class:`VideoStreamConcat <scenedetect.backends.concat.VideoStreamConcat>`).
         frame_rate: Overrides detected frame rate if set. Takes precedence over `framerate`.
         backend: Name of specific backend to use, if possible. See
             :data:`scenedetect.backends.AVAILABLE_BACKENDS` for backends available on the current
@@ -113,6 +117,10 @@ def open_video(
     # used, once internal callers and downstream users have had a release to migrate.
     if frame_rate is None:
         frame_rate = framerate
+    # A list of paths is opened as a single concatenated stream. VideoStreamConcat handles
+    # backend selection/fallback internally, so this must come before the lookup below.
+    if isinstance(path, (list, tuple)):
+        return VideoStreamConcat(path, frame_rate, backend=backend, **kwargs)
     last_error: Exception | None = None
     # If `backend` is available, try to open the video at `path` using it.
     if backend in AVAILABLE_BACKENDS:
@@ -142,18 +150,21 @@ def open_video(
 
 
 def detect(
-    video_path: StrPath,
+    video_path: "StrPath | list[StrPath] | tuple[StrPath, ...]",
     detector: SceneDetector,
     stats_file_path: StrPath | None = None,
     show_progress: bool = False,
     start_time: TimecodeLike | None = None,
     end_time: TimecodeLike | None = None,
     start_in_scene: bool = False,
+    backend: str = "opencv",
 ) -> SceneList:
     """Perform scene detection on a given video `path` using the specified `detector`.
 
     Arguments:
-        video_path: Path to input video (absolute or relative to working directory).
+        video_path: Path to input video (absolute or relative to working directory). May also
+            be a list of paths, in which case the videos are concatenated and treated as a
+            single continuous stream.
         detector: A `SceneDetector` instance (see :mod:`scenedetect.detectors` for a full list
             of detectors).
         stats_file_path: Path to save per-frame metrics to for statistical analysis or to
@@ -168,6 +179,10 @@ def detect(
             will contain a single scene spanning the entire video (instead of no scenes).
             When detecting fades with `ThresholdDetector`, the beginning portion of the video
             will always be included until the first fade-out event is detected.
+        backend: Name of the backend to use for video decoding. See
+            :data:`scenedetect.backends.AVAILABLE_BACKENDS` for backends available on the
+            current system. Defaults to OpenCV; falls back to OpenCV if the requested backend
+            is unavailable or fails to open the video.
 
     Returns:
         List of scenes as pairs of (start, end) :class:`FrameTimecode` objects.
@@ -178,7 +193,7 @@ def detect(
         ValueError: `start_time` or `end_time` are incorrectly formatted.
         TypeError: `start_time` or `end_time` are invalid types.
     """
-    video = open_video(video_path)
+    video = open_video(video_path, backend=backend)
     if start_time is not None:
         video.seek(FrameTimecode(start_time, video.frame_rate))
     end_timecode = FrameTimecode(end_time, video.frame_rate) if end_time is not None else None

{scenedetect-0.7 → scenedetect-0.7.1.dev0}/scenedetect/_cli/__init__.py

@@ -1294,6 +1294,15 @@ Customized filenames:
         USER_CONFIG.get_help_string("split-video", "mkvmerge")
     ),
 )
+@click.option(
+    "--expand",
+    is_flag=True,
+    flag_value=True,
+    default=False,
+    help="Extend the first/last output clips to cover the full input video, even if `time -s/-e` limited the analysis window. Useful for keeping content outside the analyzed region attached to the adjacent split.{}".format(
+        USER_CONFIG.get_help_string("split-video", "expand")
+    ),
+)
 @click.pass_context
 def split_video_command(
     ctx: click.Context,
@@ -1306,6 +1315,7 @@ def split_video_command(
     preset: str | None,
     args: str | None,
     mkvmerge: bool,
+    expand: bool,
 ):
     ctx = ctx.obj
     assert isinstance(ctx, CliContext)
@@ -1372,6 +1382,7 @@ def split_video_command(
         "output": ctx.config.get_value("split-video", "output", output),
         "show_output": not ctx.config.get_value("split-video", "quiet", quiet),
         "ffmpeg_args": args,
+        "expand": ctx.config.get_value("split-video", "expand", expand),
     }
     ctx.add_command(cli_commands.split_video, split_video_args)
 

{scenedetect-0.7 → scenedetect-0.7.1.dev0}/scenedetect/_cli/commands.py

@@ -37,6 +37,7 @@ from scenedetect.scene_manager import (
     CutList,
     Interpolation,
     SceneList,
+    expand_scenes_to_bounds,
 )
 
 logger = logging.getLogger("pyscenedetect")
@@ -216,11 +217,23 @@ def split_video(
     output: str,
     show_output: bool,
     ffmpeg_args: str,
+    expand: bool,
 ):
     """Handles the `split-video` command."""
     del cuts  # split-video only uses scenes.
     assert context.video_stream is not None
 
+    if expand and scenes:
+        video_duration = context.video_stream.duration
+        if video_duration is None:
+            logger.warning("Cannot --expand: video duration is unavailable for this stream.")
+        else:
+            scenes = expand_scenes_to_bounds(
+                scenes,
+                start=context.video_stream.base_timecode,
+                end=video_duration,
+            )
+
     if use_mkvmerge:
         name_format = name_format.removesuffix("-$SCENE_NUMBER")
 

{scenedetect-0.7 → scenedetect-0.7.1.dev0}/scenedetect/_cli/config.py

@@ -468,6 +468,7 @@ CONFIG_MAP: ConfigDict = {
     "split-video": {
         "args": _DEFAULT_FFMPEG_ARGS,
         "copy": False,
+        "expand": False,
         "filename": "$VIDEO_NAME-Scene-$SCENE_NUMBER",
         "high-quality": False,
         "mkvmerge": False,

{scenedetect-0.7 → scenedetect-0.7.1.dev0}/scenedetect/backends/__init__.py

@@ -50,6 +50,14 @@ Lastly, to use a specific backend directly:
 In both examples above, the resulting ``video`` can be used with
 :meth:`SceneManager.detect_scenes() <scenedetect.scene_manager.SceneManager.detect_scenes>`.
 
+Multiple videos can be opened as one continuous stream by passing a list of paths to
+:func:`open_video`, which returns a
+:class:`VideoStreamConcat <scenedetect.backends.concat.VideoStreamConcat>`:
+
+.. code:: python
+
+    video = open_video(["part1.mp4", "part2.mp4"])
+
 ===============================================================
 Devices / Cameras / Pipes
 ===============================================================
@@ -84,6 +92,7 @@ examples for details.
 #  - Nvidia VPF: https://developer.nvidia.com/blog/vpf-hardware-accelerated-video-processing-framework-in-python/
 
 # OpenCV must be available at minimum.
+from scenedetect.backends.concat import SourceSpan, VideoStreamConcat
 from scenedetect.backends.opencv import VideoCaptureAdapter, VideoStreamCv2
 
 try: