Repolode
Breakthrough

Breakthrough/PySceneDetect

Herramienta y biblioteca de Python y OpenCV que detecta cortes y transiciones de escena en videos, con opción de dividirlos en clips.

Estrellas
5,396
Forks
560
Issues abiertos
64
Último commit
hace 6 días

¿Qué es?

PySceneDetect analiza archivos de video para encontrar dónde termina un plano y empieza el siguiente. Ofrece un programa de línea de comandos y una API de Python. Sus métodos de detección incluyen la detección basada en contenido para cortes rápidos, la detección adaptativa para movimientos rápidos de cámara y la detección por umbral para fundidos desde y hacia negro.

La CLI puede dividir un video en cada escena detectada mediante ffmpeg o mkvmerge, guardar fotogramas representativos de cada escena y enumerar los códigos de tiempo de inicio y fin. Los comandos se pueden encadenar y la configuración se puede guardar en un archivo. La biblioteca ofrece funciones como detect() y split_video_ffmpeg() para usarlas en otros pipelines.

El proyecto se publica en PyPI y ofrece una imagen de Docker que incluye ffmpeg y mkvmerge. También hay instaladores MSI y versiones portables para Windows.

Funciones clave

  • 01Detecta cortes directos con detectores basados en contenido y adaptativos.
  • 02Detecta fundidos desde y hacia negro con un detector por umbral.
  • 03Divide videos en clips de escenas mediante ffmpeg o mkvmerge.
  • 04Guarda fotogramas de cada escena detectada como imágenes.
  • 05Ofrece una interfaz de línea de comandos y una API de Python.
  • 06Se distribuye mediante PyPI, Docker e instaladores para Windows.

Casos de uso

  • Dividir grabaciones largas o películas en planos individuales para editarlos o revisarlos.
  • Crear un conjunto de datos de planos o fotogramas clave para aprendizaje automático con video.
  • Generar automáticamente miniaturas o vistas previas de cada escena.
  • Incorporar la detección de escenas como paso de un pipeline de procesamiento de video.

Inicio rápido

  1. 1

    Instala el paquete desde PyPI

    pip install scenedetect --upgrade
  2. 2

    Detecta las escenas y divide el vídeo en cada corte con ffmpeg

    scenedetect -i video.mp4 split-video

Antes de usarlo

  • Para dividir vídeos, debes instalar ffmpeg o mkvmerge por separado, salvo que uses la imagen de Docker.

En colecciones

Temas

#video-processing#scene-detection#opencv#computer-vision#python#video-editing#analysis#image-processing#python-opencv#scene-recognition

Preguntas frecuentes

¿Qué es PySceneDetect?
Herramienta y biblioteca de Python y OpenCV que detecta cortes y transiciones de escena en videos, con opción de dividirlos en clips. PySceneDetect analiza archivos de video para encontrar dónde termina un plano y empieza el siguiente. Ofrece un programa de línea de comandos y una API de Python. Sus métodos de detección incluyen la detección basada en contenido para cortes rápidos, la detección adaptativa para movimientos rápidos de cámara y la detección por umbral para fundidos desde y hacia negro.
¿PySceneDetect es gratuito? ¿Qué licencia tiene?
PySceneDetect es open source bajo la licencia BSD-3-Clause. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿PySceneDetect sigue mantenido?
Mantenimiento activo. El último commit de PySceneDetect fue el 2 nov 2026.
¿Para qué puedo usar PySceneDetect?
Dividir grabaciones largas o películas en planos individuales para editarlos o revisarlos. Crear un conjunto de datos de planos o fotogramas clave para aprendizaje automático con video. Generar automáticamente miniaturas o vistas previas de cada escena. Incorporar la detección de escenas como paso de un pipeline de procesamiento de video.
¿Cómo se instala PySceneDetect?
Instala el paquete desde PyPI: pip install scenedetect --upgrade Detecta las escenas y divide el vídeo en cada corte con ffmpeg: scenedetect -i video.mp4 split-video
¿Dónde consigo PySceneDetect?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Breakthrough/PySceneDetect

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados