Communitygithub.com

video-filmstrip

비디오에서 프레임을 추출하고, 4K 4열 필름스트립 그리드, 평균 색상 바코드 이미지 및 평균 RGB CSV를 FFmpeg와 Python을 사용하여 생성합니다.

video-filmstrip란 무엇인가요?

이 스킬은 FFmpeg과 Python 표준 라이브러리만을 사용하여 비디오 파일로부터 추출된 프레임 아카이브, 4열 4K 필름스트립 그리드, 평균 색상 바코드 이미지 및 평균 RGB CSV 파일을 생성합니다. 개발자나 AI 에이전트 사용자는 이를 통해 비디오의 시각적 요약, 프레임 분석, 썸네일 생성 또는 머신러닝 데이터 준비 작업을 손쉽게 수행할 수 있습니다. Cursor, Claude Code, Codex 등 다양한 플랫폼에서 지원되며, 사용자가 프레임 번호 표시 여부, 출력 프레임 레이트, 해상도, 시작/종료 시간 등을 선택할 수 있습니다. 스크립트는 자동으로 여러 그리드 시트로 분할하고, 각 프레임의 평균 RGB 값을 CSV로 기록하여 추가 분석에 활용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ajtopper/filmstrip-skill/tree/HEAD/skills/video-filmstrip

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

비디오 필름스트립

FFmpeg와 Python 표준 라이브러리만 사용하여 (타사 패키지 없이) 모든 비디오 파일에서 추출된 프레임 아카이브, 4열 4K 필름스트립 그리드, 평균 색상 바코드 이미지 및 평균 RGB CSV를 생성합니다.

전제 조건

실행 전에 ffmpeg, ffprobe, python이 PATH에 있는지 확인하세요:

ffmpeg -version; ffprobe -version; python --version

절차

  1. 입력 비디오 경로를 확인하고 사용자에게 필름스트립 그리드 타일에 프레임 배지를 표시할지 또는 표시하지 않을지 묻습니다 (이미 요청에 명시되지 않은 경우). 또한 선택적 재정의 항목(프레임 속도, 출력 디렉터리, 접두사, 시작/지속 시간 자르기 또는 사용자 지정 크기)에 대해서도 묻습니다.
  2. 다음 명령으로 입력 비디오 경로를 사용하여 generate_filmstrip.py를 실행합니다:
python "<skill_dir>/scripts/generate_filmstrip.py" "<input_video>"

기본값을 재정의할 때만 선택적 플래그를 전달하세요:

  • --no-frame-numbers: 그리드 시트에서 왼쪽 하단 16px 프레임 배지를 생략합니다 (사용자가 번호 없는 타일을 선택한 경우 전달)
  • --output-dir <dir>: 대상 디렉터리 (기본값: 입력 비디오 옆 <prefix>_filmstrip)
  • --prefix <name>: 출력 파일명 접두사 (기본값: 입력 비디오 파일명)
  • --fps <rate>: 초당 추출할 프레임 수 (기본값: 1.0)
  • --cols <count>: 그리드 열 개수 (기본값: 4)
  • --grid-width <px>: 그리드 전체 너비(픽셀) (기본값: 3840)
  • --barcode-height <px>: 평균 색상 바코드 높이(픽셀) (기본값: 715)
  • --barcode-stripe-width <px>: 프레임당 바코드 너비(픽셀) (기본값: 1)
  • --quality <2-31>: FFmpeg MJPEG 품질(낮을수록 좋음) (기본값: 2)
  • --start <sec>: 시작 오프셋(초) (-ss)
  • --duration <sec>: 클립 지속 시간(초) (-t)
  1. 출력 폴더 내에서 생성된 아티팩트를 확인합니다:
    • frames/<prefix>-001.jpeg ... (원본 비디오 해상도로 유지된 추출 프레임, 배지 없음)
    • <prefix>_grid.jpeg 또는 번호가 매겨진 <prefix>_grid-001.jpeg ... (4열 필름스트립 그리드 시트, --no-frame-numbers가 전달되지 않은 경우 왼쪽 하단 16px 프레임 배지 포함, FFmpeg의 65500px JPEG 높이 제한에서 자동 분할)
    • <prefix>_averagesRGB.jpeg (평균 색상 바코드)
    • <prefix>_averagesRGB.csv (frame,timestamp_sec,r,g,b 행, 추출된 프레임 수와 일치)
  2. 출력 디렉터리와 생성된 그리드 시트, 바코드, CSV, 프레임 폴더의 클릭 가능한 링크를 보고합니다.

관련 스킬