Biblioteca open source de visão computacional, com algoritmos de processamento de imagens e visão computacional em C++ e bindings para várias linguagens.
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
Instale o pacote do PyPI
pip install scenedetect --upgrade - 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
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
Wrappers Java e classes auxiliares para OpenCV, FFmpeg e outras bibliotecas de visão computacional e multimídia.
Uma compilação mínima e multiplataforma do OpenCV, com um conjunto reduzido de módulos e binários menores para Android, iOS, ARM Linux, Windows e outros sistemas.
Biblioteca Python para edição programática de vídeo: cortes, concatenação, sobreposição de texto, composição e efeitos personalizados em vídeo, áudio e GIF.
Pacote Python para unir imagens com rapidez e robustez e criar panoramas a partir de fotos sobrepostas, usando o módulo de stitching do OpenCV.
Suíte de processamento de arquivos auto-hospedada que converte, compacta, edita e faz OCR em imagens, vídeos, áudios, PDFs e documentos pela interface web, API REST ou pipelines.