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