YouTube Korean Subtitle Auto-Insertion Service

YouTube 영상에 한글 자막을 자동으로 만들어 넣는 프로젝트입니다. Claude가 영상을 다운로드하고, 영어 자막을 이해한 후 맥락을 고려하여 한글로 번역하고, 최종적으로 영상에 자막을 직접 합성합니다.

이 프로젝트의 특별한 점

일반적인 자동 번역 도구와 달리, 이 프로젝트는 Claude의 이해 능력을 활용합니다. 단순히 문장을 번역하는 것이 아니라, 영상의 주제를 파악하고 관련 정보를 웹에서 찾아보며, 전문 용어를 일관되게 번역하고, 문화적 맥락을 고려합니다.

어떻게 작동하나요?

Claude Code에서 프로젝트를 열고 이렇게 말하면 됩니다:

"이 유튜브 영상에 한글 자막 넣어줘: https://youtube.com/watch?v=..."

그러면 Claude가 자동으로 전체 과정을 진행합니다.

무엇을 할 수 있나요?

자동 영상 처리

• YouTube 영상과 영어 자막을 자동으로 가져옵니다
• 자막의 기술적 문제(겹치는 타이밍, 중복 등)를 자동으로 해결합니다
• 완성된 영상에는 한글 자막이 영구적으로 합성되어 있습니다

똑똑한 번역

• Claude가 영상의 제목, 설명, 내용을 모두 분석합니다
• 웹에서 관련 정보를 찾아 전문 용어를 정확히 번역합니다
• 영상의 분위기(교육적, 캐주얼, 공식적 등)에 맞춰 번역 스타일을 조절합니다
• 한국어로 자연스럽게 읽히도록 문장 구조를 재구성합니다

품질 보장

• 번역 전후의 자막 개수가 정확히 일치하는지 검증합니다
• 전문 용어의 일관성을 유지합니다
• 자막 타이밍과 번역이 정확히 동기화됩니다

시작하기

필요한 것

• Python 3.7 이상이 설치되어 있어야 합니다
• FFmpeg이 설치되어 있어야 합니다 (영상 처리 도구)
• Claude Code에서 이 프로젝트를 열어야 합니다

자세한 설정 방법은 .claude/skills/youtube-kr-subtitle/SKILL.md 파일을 참고하세요.

작동 원리

이 프로젝트는 크게 6단계로 작동합니다:

1단계: 영상 가져오기 YouTube에서 영상과 영어 자막을 다운로드합니다. 영상의 제목, 설명, 길이 같은 정보도 함께 수집합니다.

2단계: 자막 정리 YouTube 자막은 종종 기술적 문제가 있습니다. 타이밍이 겹치거나, 같은 내용이 반복되거나, 너무 짧게 쪼개져 있는 경우가 많습니다. 이 단계에서 이런 문제들을 자동으로 해결하고, 자막을 자연스러운 문장 단위로 묶습니다.

3단계: 맥락 파악 Claude가 영상을 분석합니다. 어떤 주제인지, 어떤 전문 용어가 사용되는지, 어떤 분위기인지 파악합니다.

[중요] 반드시 웹에서 관련 정보를 찾아봅니다.

4단계: 번역 단순 기계 번역이 아닌, 맥락을 이해한 번역을 합니다. 전문 용어는 일관되게 번역하고, 영상의 분위기에 맞게 문체를 조절하며, 한국어로 자연스럽게 읽히도록 문장을 재구성합니다.

5단계: 자막 파일 생성 번역된 내용을 원본 자막의 타이밍 정보와 결합하여 한글 자막 파일을 만듭니다.

6단계: 영상 합성 FFmpeg을 사용하여 한글 자막을 영상에 직접 합성합니다. 완성된 영상은 자막이 영구적으로 포함되어 있어 별도의 자막 파일 없이도 볼 수 있습니다.

기술적 특징

자막 타이밍 문제 자동 해결 YouTube 자동 생성 자막은 "롤링 캡션" 방식을 사용하여 의도적으로 타이밍이 겹칩니다. 이 프로젝트는 이를 자동으로 감지하고 수정하여 깔끔한 자막을 만듭니다.

번역 품질 검증 번역 전후의 자막 개수가 정확히 일치하는지 자동으로 확인합니다. 이를 통해 자막과 타이밍이 어긋나는 것을 방지합니다.

자동 문장 병합 너무 짧게 쪼개진 자막을 자연스러운 문장 단위로 묶어줍니다. 이렇게 하면 번역 품질이 더 좋아지고, 자막을 읽기도 편해집니다.

현재 제한사항

• 영어 자막이 있는 영상만 처리할 수 있습니다 (자동 생성 자막도 가능)
• 자막이 전혀 없는 영상은 현재 지원하지 않습니다
• 긴 영상은 처리 시간이 오래 걸릴 수 있습니다

프로젝트 구조

프로젝트 파일은 다음과 같이 구성되어 있습니다:

• .claude/skills/youtube-kr-subtitle/ - Claude Code 스킬의 핵심 부분
  • SKILL.md - 상세한 사용 방법과 워크플로우 설명
  • scripts/ - 각 단계를 처리하는 Python 스크립트들
• downloads/ - 다운로드한 영상과 원본 자막 임시 저장소
• output/ - 한글 자막이 합성된 최종 영상 저장소

더 알아보기

기술적인 세부사항이나 스크립트 사용법이 궁금하다면 .claude/skills/youtube-kr-subtitle/SKILL.md 파일을 참고하세요. 각 단계의 상세한 설명과 예시가 포함되어 있습니다.

저작권 관련

이 프로젝트는 교육 및 공익 목적으로 제공됩니다. 원본 영상의 저작권은 원저작권자에게 있으며, YouTube 시스템을 통해 저작권 허가를 확인합니다. 본 도구는 교육, 동기부여, 아이디어 공유 등의 목적으로 사용되며, YouTube 수익은 전혀 발생하지 않습니다.

삭제, 수정 등 요청사항이 있으시면 문의해주시기 바랍니다.