비디오 대본 다운로더
./scripts/vtd.js는 다음 작업을 수행할 수 있습니다:
- 대본을 깔끔한 문단 형태로 출력(타임스탬프 선택 가능).
- 비디오/오디오/자막 다운로드.
대본 처리 방식:
- YouTube: 가능한 경우
youtube-transcript-plus를 통해 가져옴. - 그 외: yt-dlp로 자막을 추출한 후 문단으로 정리.
설정
cd ~/Projects/agent-scripts/skills/video-transcript-downloader && npm ci
대본 (기본값: 깔끔한 문단)
./scripts/vtd.js transcript --url 'https://…'
./scripts/vtd.js transcript --url 'https://…' --lang en
./scripts/vtd.js transcript --url 'https://…' --timestamps
./scripts/vtd.js transcript --url 'https://…' --keep-brackets
비디오 / 오디오 / 자막 다운로드
./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads
./scripts/vtd.js audio --url 'https://…' --output-dir ~/Downloads
./scripts/vtd.js subs --url 'https://…' --output-dir ~/Downloads --lang en
포맷 (목록 + 선택)
사용 가능한 포맷 목록(포맷 ID, 해상도, 컨테이너, 오디오 전용 등) 보기:
./scripts/vtd.js formats --url 'https://…'
특정 포맷 ID 다운로드 (예시):
./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --format 137+140
재인코딩 없이 MP4 컨테이너 선호 (가능하면 리먹스):
./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --remux-video mp4
참고 사항
- 기본 대본 출력은 하나의 문단입니다. 요청 시에만
--timestamps를 사용하세요. [Music]같은 괄호 안 큐는 기본적으로 제거되며,--keep-brackets를 사용하여 유지할 수 있습니다.- 추가 yt-dlp 인자는
--뒤에 전달할 수 있습니다 (transcript폴백,download,audio,subs,formats모두 가능).
./scripts/vtd.js formats --url 'https://…' -- -v
문제 해결 (필요할 때만)
yt-dlp/ffmpeg누락 시:
brew install yt-dlp ffmpeg
- 확인:
yt-dlp --version
ffmpeg -version | head -n 1