Repolode
Breakthrough

Breakthrough/PySceneDetect

Ferramenta e biblioteca em Python e OpenCV que detecta cortes e transições de cena em vídeos, com opção de dividir o vídeo em clipes.

Estrelas
5,396
Forks
560
Issues abertas
64
Último commit
há 6 dias

O que é?

O PySceneDetect analisa arquivos de vídeo para identificar onde um plano termina e o próximo começa. Ele oferece um programa de linha de comando e uma API Python. Os métodos de detecção incluem a detecção com análise de conteúdo, voltada a cortes rápidos; a detecção adaptativa, para movimentos rápidos de câmera; e a detecção por limiar, para transições de e para preto.

A CLI pode dividir um vídeo em cada cena detectada usando ffmpeg ou mkvmerge, salvar quadros representativos de cada cena e listar os timecodes de início e fim. Os comandos podem ser encadeados, e as configurações podem ser armazenadas em um arquivo de configuração. A biblioteca disponibiliza funções como detect() e split_video_ffmpeg() para uso em outros pipelines.

O projeto é publicado no PyPI e oferece uma imagem Docker com ffmpeg e mkvmerge incluídos. Também são disponibilizadas versões MSI e portáteis para Windows.

Recursos principais

  • 01Detecta cortes secos com detectores baseados em conteúdo e adaptativos.
  • 02Detecta transições de e para preto com um detector por limiar.
  • 03Divide vídeos em clipes de cena usando ffmpeg ou mkvmerge.
  • 04Salva quadros de cada cena detectada como imagens.
  • 05Oferece uma interface de linha de comando e uma API Python.
  • 06Distribuído via PyPI, Docker e instaladores para Windows.

Casos de uso

  • Dividir gravações longas ou filmes em planos individuais para edição ou revisão.
  • Criar um conjunto de dados de planos ou keyframes para machine learning com vídeo.
  • Gerar thumbnails ou prévias automaticamente para cada cena.
  • Adicionar a detecção de cenas como etapa de um pipeline de processamento de vídeo.

Início rápido

  1. 1

    Instale o pacote do PyPI

    pip install scenedetect --upgrade
  2. 2

    Detecte as cenas e divida o vídeo em cada corte usando ffmpeg

    scenedetect -i video.mp4 split-video

Antes de usar

  • A divisão de vídeos exige que ffmpeg ou mkvmerge sejam instalados separadamente, a menos que você use a imagem Docker.

Em coleções

Tópicos

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

Perguntas frequentes

O que é PySceneDetect?
Ferramenta e biblioteca em Python e OpenCV que detecta cortes e transições de cena em vídeos, com opção de dividir o vídeo em clipes. O PySceneDetect analisa arquivos de vídeo para identificar onde um plano termina e o próximo começa. Ele oferece um programa de linha de comando e uma API Python. Os métodos de detecção incluem a detecção com análise de conteúdo, voltada a cortes rápidos; a detecção adaptativa, para movimentos rápidos de câmera; e a detecção por limiar, para transições de e para preto.
PySceneDetect é gratuito? Qual é a licença?
PySceneDetect é open source sob a licença BSD-3-Clause. Confira os termos da licença antes de usá-lo em produtos comerciais.
PySceneDetect ainda é mantido?
Manutenção ativa. O último commit de PySceneDetect foi em 2 de nov. de 2026.
Para que posso usar PySceneDetect?
Dividir gravações longas ou filmes em planos individuais para edição ou revisão. Criar um conjunto de dados de planos ou keyframes para machine learning com vídeo. Gerar thumbnails ou prévias automaticamente para cada cena. Adicionar a detecção de cenas como etapa de um pipeline de processamento de vídeo.
Como instalar PySceneDetect?
Instale o pacote do PyPI: pip install scenedetect --upgrade Detecte as cenas e divida o vídeo em cada corte usando ffmpeg: scenedetect -i video.mp4 split-video
Onde consigo PySceneDetect?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Breakthrough/PySceneDetect

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados