
YouTube 자막 다운로드
Prosey는 YouTube에서 동영상 자막을 다운로드하고 표시하는 CLI 도구로, 몇 시간을 낭비하지 않고도 원하는 정보를 얻을 수 있습니다.
주요 사용 사례는 다음과 같습니다:
두 사용 사례 모두 시스템에 AI 어시스턴트가 필요합니다 (기본값: opencode, prosey config를 사용하여 직접 구성 가능).
시스템에서 구문 강조 도구를 감지하면 멋진 컬러 출력을 얻을 수 있습니다.
Prosey는 네이티브 json 형식을 그대로 출력하거나 저장할 수도 있습니다.
| 기능 | 설명 |
|---|---|
| 💡 요약 | 동영상 자막을 가져와 요약 |
| 📖 읽기 | 자막을 가져와 Markdown 형식으로 표시 |
| 💬 복사 | 요약을 클립보드에 복사하여 웹 채팅에 바로 붙여넣기 가능 |
| 📋 자막 다운로드 | YouTube 자막을 일반 텍스트 또는 JSON 그대로 가져오기 |
| 🤖 AI 요약 | 자막을 모든 AI 에이전트(opencode, Claude, Copilot, Codex)로 파이프 |
| 🎨 스마트 페이저 | bat, glow 또는 mdcat이 설치되어 있으면 자동 구문 강조 (또는 자체 페이저 구성) |
| 🛠️ 사용자 정의 | prosey config를 사용하여 구성에 접근 및 편집 / 프롬프트 사용자 정의 |
| 💾 디스크 캐싱 | 자막과 요약이 디스크에 캐시되어 즉시 다시 읽기 가능 |
| 📄 지원 형식 | 일반 텍스트 및 JSON |
npx로 즉시 사용해 보세요:
npx @tacone/prosey 771PQEDeRmw
npx @tacone/prosey https://youtu.be/771PQEDeRmw --lang es -o transcript.txt
선호하는 패키지 관리자로 전역 설치하세요:
npm install -g @tacone/prosey
# or
yarn global add @tacone/prosey
# or
pnpm add -g @tacone/prosey
# or
bun install -g @tacone/prosey
그런 다음 어디서든 사용하세요:
prosey 771PQEDeRmw
개발에는 **Bun**을 사용합니다 — 스크립트, 패키지 관리, 그리고 TypeScript 소스를 직접 실행하는 데 사용됩니다.
git clone https://github.com/tacone/prosey.git
cd prosey
bun install
bun run start -- 771PQEDeRmw
prosey [options] <video controls-url-or-id>
prosey read [options] <video controls-url-or-id>
prosey info [options] <video controls-url-or-id>
prosey summarize [options] <video controls-url-or-id>
prosey copy [--question <text>] <folder>
prosey index
prosey render
prosey config
prosey help
summarize가 기본 명령이므로 prosey <id>를 실행하면 AI 요약기가 실행됩니다.
prosey read <id>를 사용하면 서식이 풍부한 트랜스크립트를 다운로드하여 출력합니다.
summarize 명령은 트랜스크립트를 가져와 [summarize] 설정 섹션의 프롬프트를 앞에 붙이고, 그 결과를 설정된 AI 명령으로 파이프합니다.
read 명령은 트랜스크립트를 다운로드하여 stdout으로 출력합니다(일반 텍스트, 마크다운 또는 JSON). AI 처리가 필요하지 않을 때 유용합니다.
info 명령은 동영상 메타데이터(제목, 채널, 길이, 조회수)를 표시합니다.
index 명령은 문서 인덱스를 다시 빌드하고 브라우저에서 엽니다.
인덱스에는 데이터 디렉터리에 저장된 모든 요약과 트랜스크립션이 나열되며,
각 summarize/transcribe 실행 후 자동으로 다시 빌드됩니다. 콘텐츠 페이지에서
Prosey 로고를 클릭하면 인덱스로 돌아갑니다.
render 명령은 캐시된 마크다운에서 모든 HTML 페이지를 다시 생성하고(네트워크나 AI 처리 없음) 인덱스를 다시 작성합니다.
copy 명령은 문서의 요약을 클립보드에 복사하여 웹 채팅에 붙여넣을 수 있게 합니다. 마지막 실행 끝에 출력된 폴더 이름(또는 전체 경로)을 받으며, --question은 요약 뒤에 두 개의 빈 줄로 구분하여 질문을 덧붙입니다. 요약만 복사할 수 있으며, 트랜스크립트만 있는 폴더는 오류입니다.
요약 페이지의 메타 줄에는 읽기 시간 오른쪽에 Copy 링크가 있습니다. 이 링크는 요약을 클립보드에 넣어 웹 채팅에 붙여넣을 수 있게 합니다.
config 명령은 편집을 위해 $EDITOR에서 설정 파일을 엽니다. 연결할 터미널이 없을 때 — $EDITOR가 설정되지 않았거나 stdout/stdin이 파이프된 경우 — 설정 파일 경로가 대신 출력됩니다.
help 명령은 --help와 동일하게 도움말 메시지를 표시합니다.
# Summarize (AI summary + formatting + syntax highlighting)
prosey 771PQEDeRmw
# Summarize (same as above)
prosey summarize 771PQEDeRmw
# Transcribe (AI summary + formatting + syntax highlighting)
prosey read 771PQEDeRmw
# Show video metadata
prosey info 771PQEDeRmw
# Edit config in $EDITOR
prosey config
# List available languages
prosey read https://youtu.be/771PQEDeRmw --list
# Specify language
prosey read https://youtu.be/771PQEDeRmw --lang es
# Display JSON (no AI transcription)
prosey read 771PQEDeRmw
# Display plain text (no AI transcription)
prosey read 771PQEDeRmw
# Save transcript to file
prosey read 771PQEDeRmw -o transcript.txt
| 플래그 | 설명 |
|---|---|
--lang <code> | 언어 코드(예: en, fr). 생략하면 자동 감지됩니다. |
-t, --timestamps | 텍스트 출력의 각 줄 앞에 [MM:SS]를 붙입니다. |
--list | 동영상에서 사용 가능한 자막 언어를 나열한 후 종료합니다. |
-o, --output <path> | 출력을 stdout 대신 파일에 기록합니다. |
--json | 자막을 JSON 배열로 출력합니다. 각 항목에는 text, offset(초), duration, timestamp가 포함됩니다. |
--text | 일반 텍스트로 출력합니다(prosey read의 기본값). |
--details | 자막 앞에 동영상 세부 정보(제목, 채널, 길이, 조회수, 설명)를 붙입니다(기본값). |
--no-details | 동영상 세부 정보를 생략하고 자막만 출력합니다. |
--no-decode-entities | 원시 HTML 엔티티(예: ')를 그대로 유지합니다. 텍스트 모드에서는 기본적으로 디코딩됩니다. |
--question <text> | 복사할 때 요약에 질문을 추가합니다. |
--no-cache | 캐시 읽기를 건너뛰고 새로 가져오도록 강제합니다. |
--no-format | summarize 출력에 대한 prettier 마크다운 서식을 건너뜁니다. |
-q, --quiet | 모든 stderr 로깅을 억제합니다. |
-v, --verbose | 디버그 정보를 stderr에 출력합니다. |
--no-pager | stdout 출력에 대한 페이저를 비활성화합니다(기본적으로 자동 감지). |
--pager | stdout 출력에 페이저를 사용합니다(기본값). |
--reset-config | 구성 파일을 기본값으로 재설정하고 종료합니다. |
--help | 도움말 메시지를 표시하고 종료합니다. |
--version | 버전 번호를 표시하고 종료합니다. |
--json을 사용하면 출력은 객체의 배열입니다:
[
{
"text": "♪ We're no strangers to love ♪",
"offset": 18.64,
"duration": 3.24,
"timestamp": "00:18"
}
]
timestamp는 JSON 모드에서 항상 존재합니다. JSON은 구조화된 데이터이므로 비디오 세부 정보는 (조용히) 억제됩니다.
이 프로젝트는 개발을 위해 Bun 을 사용합니다.
bun run typecheck # TypeScript check
bun run start # Run the CLI from source
bun run test # Run unit tests
bun run build # Compile Node bundle to bin/prosey
npm에 게시하기 전에 prepack 훅을 통해 bun run build가 자동으로 실행되어 bin/prosey에 Node 호환 JS 번들을 생성합니다.