Video Transcript Downloader
./scripts/vtd.js 는 다음 작업을 수행할 수 있습니다:
- 대본을 깔끔한 문단으로 출력 (타임스탬프 선택 가능)
- 동영상/오디오/자막 다운로드
대본 동작 방식:
- YouTube: 가능한 경우
youtube-transcript-plus를 통해 가져옴 - 그 외:
yt-dlp로 자막을 추출한 후 문단으로 정리
설정
cd ~/Projects/agent-scripts/skills/video-transcript-downloader && npm ci
CLI 구문:
./scripts/vtd.js --help
./scripts/vtd.js transcript --help
하위 명령어는 --url 없이도 집중된 도움말을 지원합니다.
대본 (기본값: 깔끔한 문단)
./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