Project

General

Profile

Actions

Feature #669

closed
성양 성양

Feature #666: [VID] 설교 영상 자동화 시스템 (V2)

Feature #667: [VID-00] 사전 검증 (실제 예배 영상 수령 후 진행)

[VID-00-02] FFmpeg 샘플 설교 구간 자르기

Feature #669: [VID-00-02] FFmpeg 샘플 설교 구간 자르기

Added by 성용 양 26 days ago. Updated 15 days ago.

Status:
Closed
Priority:
Normal
Assignee:
Target version:
-
Start date:
10/26/2026
Due date:
11/05/2026
% Done:

100%

Estimated time:

Description

담당: 양성용

목적

FFmpeg만으로 설교 구간을 정확히 자를 수 있는지, 음성·영상이 어긋나지 않는지 확인한다.

전제·입력

실제 영상 1~2회차, 사람이 눈으로 확인한 설교 시작·종료 시각(임시 기준).

작업 순서

  1. 영상 하나에서 사람이 정한 시작·종료 시각으로 FFmpeg 컷을 실행(-ss, -to).
  2. 두 방식을 비교: 스트림 복사(-c copy, 빠르지만 시작 지점이 어긋날 수 있음) vs 재인코딩(느리지만 정확).
  3. 잘린 영상을 재생해 음성·영상 싱크, 시작·끝 잘림 여부를 확인.
  4. 방식별 처리 시간과 결과 용량을 기록하고 사용할 방식을 제안.

사용 기술·도구

FFmpeg(-ss, -to, -c copy/재인코딩)

산출물

방식별 비교 결과와 권장 FFmpeg 명령 예시

완료 기준

  • 시작·끝 문장이 잘리지 않는다.
  • 음성·영상 싱크가 정상이다.
  • 처리 시간·용량이 기록되어 VID-02-06의 방식이 정해졌다.

이 일감에서 하지 않는 것

AI로 구간을 찾는 일은 하지 않는다(VID-00-04).

주의·미확정 사항

스트림 복사는 키프레임 때문에 시작이 몇 초 어긋날 수 있다. 재생 확인 필수.

수정할 파일: VID-01-01(기존 코드 확인) 완료 후 기재

연결 일감

선행: 없음 / 후행: VID-02-06

예상 공수: VID-00 검증 결과 후 확정

성양 Updated by 성용 양 26 days ago Actions #1

  • Description updated (diff)
  • Assignee set to 성용 양

성양 Updated by 성용 양 26 days ago Actions #2

  • Due date set to 10/26/2026
  • Start date set to 10/26/2026

성양 Updated by 성용 양 26 days ago Actions #3

  • Description updated (diff)

성양 Updated by 성용 양 25 days ago Actions #4

GitHub PR #61(build: add FFmpeg for sermon video processing)이 열려 있음(리뷰 대기). 서버 이미지에 FFmpeg를 추가하는 선행 준비이며, 이 일감의 샘플 자르기 시험은 10/26 예정대로 진행.

성양 Updated by 성용 양 25 days ago Actions #5

  • Status changed from New to In Progress

2026-10-23 사전 검증 진행: PR #61(FFmpeg 서버 이미지 추가)은 main에 병합됨. 제공된 「2026 07 19 주일설교 박은조 목사.mp4」(28분 32.56초, H.264/AAC, 1280×720)에서 임의의 2:00.25~2:30.25 구간을 비교함. 스트림 복사: 30.192초/3,966,983B/0.98초, 재인코딩(libx264/AAC): 30.072초/1,841,131B/2.57초. 두 파일 모두 FFmpeg 전체 디코딩 오류 없음. 이 원본은 이미 설교만 편집된 영상으로 보여 전체 예배에서 설교 경계를 찾는 검증에는 적합하지 않음. 구간도 사람이 확인한 문장 경계가 아니므로 시작·끝 문장 및 음성 싱크의 청취 검증과 최종 방식 선정은 미완료. 전체 예배 원본 또는 사람 확인 시작·종료 시각을 확보한 뒤 #669를 완료 판정하겠음.

성양 Updated by 성용 양 23 days ago Actions #6

  • % Done changed from 0 to 60

한 줄 요약

FFmpeg로 영상을 자를 수 있는 환경을 준비했고, 실제 설교 편집본의 정보까지 확인했습니다. 사람이 눈과 귀로 자른 경계를 확인하는 단계가 남아 있어 진행 중입니다.

왜 했나 (목적)

나중에 AI가 "여기부터 여기까지가 설교"라고 알려 주면 그 구간을 정확히 잘라야 합니다. 그 일을 FFmpeg 하나로 할 수 있는지, 음성과 영상이 어긋나지 않는지 미리 확인하는 일감입니다.

어떤 순서로 했나

  1. 서버용 Docker 이미지에 FFmpeg가 들어 있게 하는 작업을 GitHub PR #61(build: add FFmpeg for sermon video processing)로 올렸고 병합되었습니다.
  2. 개인 PC(Windows)에는 ffmpeg 명령이 없어서, FFmpeg가 들어 있는 기존 Docker 이미지를 재사용해 시험했습니다(PR #63 문서 기준).
  3. 합성(만든) 영상과 실제 설교 편집본의 일부 구간으로 자르기 시험을 했고 결과는 로컬 문서 docs/VIDEO_FFMPEG_POC.md에 기록되어 있다고 합니다(GitHub에는 아직 없음).
  4. 실제 시험 영상 정보: 길이 28분 32.56초, H.264 영상, AAC 음성, 1280×720, 약 23.98fps.

사용한 도구

  • FFmpeg / FFprobe: 영상을 자르고 정보를 읽는 무료 도구
  • Docker: FFmpeg를 PC에 직접 설치하지 않고 격리된 환경에서 실행
  • Codex 자동 리뷰: PR #61에 GitHub 자동 코드 리뷰(Codex)가 완료됨

결정한 것과 이유

  • Windows에 FFmpeg를 새로 설치하지 않고 Docker 이미지를 재사용: 팀원 PC 환경이 달라도 같은 방식으로 재현할 수 있고 PC를 건드리지 않기 때문입니다.
  • 원본 영상은 읽기 전용으로만 연결: 원본이 바뀌면 되돌릴 수 없어서입니다.

아직 안 된 것

  • 잘린 영상을 실제로 재생해 시작·끝 문장이 잘리지 않는지, 음성·영상 싱크가 맞는지 확인
  • 스트림 복사(빠르지만 시작이 어긋날 수 있음)와 재인코딩(느리지만 정확)의 비교 결과 정리와 권장 방식 결정
  • docs/VIDEO_FFMPEG_POC.md를 GitHub에 반영하고 PR #61 본문(변경 설명)을 채우기

근거

GitHub PR #61(병합), PR #63 문서 9절.

성양 Updated by 성용 양 22 days ago Actions #7

2026-10-26 최신 상태 및 #670과의 선후관계

PR #63 병합은 #670의 PoC 문서 반영이며 #669 완료를 의미하지 않습니다. 현재 #669에서 확인된 것은 FFmpeg 실행 환경과 임의 30초 구간의 스트림 복사·재인코딩 기술 시험까지입니다.

사람이 확인한 설교 시작·종료 시각을 기준으로 한 재생 검수, 시작·끝 문장 보존, 음성·영상 싱크 확인, 스트림 복사와 재인코딩 중 최종 방식 선정은 여전히 미완료입니다. 로컬 docs/VIDEO_FFMPEG_POC.md도 아직 GitHub에 반영되지 않았습니다. 따라서 상태와 진척도는 In Progress / 60%를 유지합니다.

#670의 5분 STT 품질 검증은 이미 편집된 설교 샘플로 독립 진행할 수 있으므로 #669가 이를 막지는 않습니다. 다만 전체 예배 영상에서 설교 구간을 잘라 전사하는 운영 흐름을 개발하기 전에는 #669를 완료해야 합니다.

다음 실행 조건은 전체 예배 원본과 사람이 확인한 설교 시작·종료 시각 확보입니다. 입력을 확보한 뒤 동일 구간을 스트림 복사와 재인코딩으로 만들고 실제 재생 검수·처리 시간·용량을 비교하여 VID-02-06에 사용할 방식을 결정합니다.

성양 Updated by 성용 양 21 days ago Actions #8

2026-10-27 #670과의 관계 정리 (상태 변화 없음)

  • #669는 FFmpeg로 설교 구간을 자르는 방식(스트림 복사 vs 재인코딩)을 정하는 선행 작업입니다. #670은 이미 편집된 설교 영상의 소리(WAV)를 쓰기 때문에 #669가 끝나지 않아도 독립적으로 진행할 수 있었고, 실제로 28분 32초 전체 로컬 전사 기준본까지 진행되었습니다.
  • 이 사실이 #669 완료를 뜻하지는 않습니다. 사람이 확인한 설교 시작·종료 시각 기준의 재생 검수, 시작·끝 문장 보존, 음성·영상 싱크 확인, 최종 방식 선정은 여전히 미완료입니다.
  • 전체 예배 영상에서 설교 구간을 잘라 전사하는 운영 흐름을 개발하기 전에는 #669를 완료해야 합니다. 조건은 전체 예배 원본과 사람이 확인한 설교 시작·종료 시각 확보입니다.
  • 따라서 #669는 In Progress / 60%를 유지합니다.

성양 Updated by 성용 양 21 days ago Actions #9

2026-10-27 후행 STT 결과 연계 및 현재 완료 조건

  • #670에서 28분 32초 설교 편집본 전체를 무료 로컬 STT로 전사하고 사람이 검수한 텍스트 기준본 v1을 확정했습니다.
  • #670 결과는 최종 427구간, 누적 텍스트 교정 33건, 의미 단위 분할 3건이며 번호 오류·잘못된 길이·구간 겹침은 0건입니다.
  • 이는 #669에서 준비한 FFmpeg/FFprobe 기반 음성 추출 경로가 후행 STT PoC에 실제로 사용되어 정상 동작했다는 근거입니다.

#669에서 확인된 범위

  • 설교 편집본에서 음성을 추출해 후행 전사 단계에 전달하는 흐름은 정상 동작했습니다.
  • 기존 임의 30초 시험에서 스트림 복사와 재인코딩 모두 기술적으로 실행되고 디코딩 오류가 없었습니다.

아직 남은 범위

  • 현재 영상은 이미 설교만 편집된 파일이므로 실제 전체 예배 영상에서 설교 시작·종료 경계를 확인하지 못했습니다.
  • 사람이 확인한 시작·종료 시각으로 자른 결과의 시작·끝 문장 보존, 영상·음성 싱크를 재생 검수해야 합니다.
  • 스트림 복사와 재인코딩 중 운영에 사용할 최종 방식을 처리 시간·용량·경계 정확도를 근거로 선정해야 합니다.
  • 로컬 docs/VIDEO_FFMPEG_POC.md의 저장소 반영 여부도 별도로 확인해야 합니다.

따라서 #670의 텍스트 기준본 완료는 #669의 선행 기반이 유효하다는 증거이지만, #669 자체의 완료 기준을 모두 충족한 것은 아닙니다. 상태와 진척도는 In Progress / 60%로 유지합니다. 다음 실행 조건은 실제 전체 예배 원본과 사람이 확인한 설교 시작·종료 시각 확보입니다.

성양 Updated by 성용 양 15 days ago Actions #10

  • Due date changed from 10/26/2026 to 11/05/2026
  • % Done changed from 60 to 70

2026-11-02 GitHub 반영

자동 판정한 설교 구간을 FFmpeg로 잘라 편집본을 만드는 기능이 구현되었고 확신도가 낮거나 길이가 비정상이면 자르지 않고 원본을 보존합니다. 사람이 재생해 시작·끝 문장 보존과 음성·영상 싱크를 확인하는 일이 남아 11/05로 조정합니다. 근거: PR #89(병합)와 PR #85(병합 없이 닫힘, 종단 검증 기록). 코드는 병합되었지만 운영 환경 검증과 GitHub Actions CI 재실행(저장소 Actions 예산 제한으로 보류)은 남아 있어 완료로 하지 않습니다.

성양 Updated by 성용 양 15 days ago Actions #11

  • Status changed from In Progress to Closed
  • % Done changed from 70 to 100

2026-11-02 완료 처리

해당 기능이 PR #89로 main에 병합되어 있어 PM 기준(CI는 고려하지 않고, 병합되었으면 100%)에 따라 완료(100%)로 처리합니다. 운영 환경 검증은 별도로 진행합니다.

Actions

Also available in: PDF Atom