thesisbug2은(는) 무엇을 하나요?
./fw yt2sub 명령어를 사용하여 YouTube 비디오 또는 로컬 오디오/비디오 파일을 평문 텍스트로 변환합니다. 작업에 구어 콘텐츠를 텍스트로 필요로 할 때 사용하세요: 사용자가 YouTube URL이나 미디어 파일을 제공하여 대화 내용을 텍스트로 변환, 요약, 또는 시청하거나, 강연, 강의, 팟캐스트에서 노트나 과제를 작성하고자 할 때 유용합니다. 먼저 YouTube 자막(zh-Hant/en)을 시도하고, 실패할 경우 로컬 faster-whisper 모델로 대체하므로, 수동으로 yt-dlp와 whisper 파이프라인을 구축하는 대신 이 명령어를 사용하세요.
사용 방법
./fw yt2sub <YouTube URL 또는 로컬 파일 경로>
예시:
./fw yt2sub https://www.youtube.com/watch?v=example./fw yt2sub /path/to/local/video.mp4
주요 기능
- 자동 자막 우선: YouTube에서 제공하는 자막(zh-Hant, en)을 먼저 시도합니다.
- 로컬 모델 폴백: 자막이 없으면 faster-whisper를 사용하여 로컬에서 전사합니다.
- 다양한 형식 지원: 비디오(MP4, WebM 등)와 오디오(MP3, WAV 등)를 포함한 여러 파일 형식을 지원합니다.
- 간편한 사용: 별도의 복잡한 설정 없이 단일 명령어로 실행 가능합니다.
지원 플랫폼
- Claude Code: Claude API를 통한 명령 실행 지원
- Cursor: 터미널 기반 워크플로우 통합
- 기타 AI 에이전트: 표준 셸 명령어로 호출 가능
주의사항
- YouTube 자막을 먼저 시도하므로, 자막이 있는 경우 빠르게 결과를 얻을 수 있습니다.
- 로컬 faster-whisper 모델은 시스템 리소스를 사용하므로, 긴 파일 처리 시 시간이 소요될 수 있습니다.
- 자막이 제공되지 않는 비디오의 경우 전사 정확도가 언어와 오디오 품질에 따라 달라질 수 있습니다.
개발자 참고
이 기술은 수동으로 yt-dlp + whisper 파이프라인을 구축하는 번거로움을 없애기 위해 설계되었습니다. 내부적으로는 yt-dlp를 사용하여 오디오를 추출하고, faster-whisper를 사용하여 전사합니다. 자막이 있는 경우에는 API 요청으로 직접 가져옵니다.
기여
버그 리포트나 기능 제안은 GitHub 이슈를 통해 제출해 주세요.