쇼츠 컴포저: 유튜브 자막·클립·하이라이트

About

**쇼츠 컴포저** 는 유튜브 영상에서 자료를 한 번에 모으고 정리할 수 있는 Chrome 사이드패널 확장입니다. 영상 시청 중 화면 옆에 띄워두고 단축키 한 번으로 핵심 구간을 잘라내거나, 자막 전체를 텍스트로 받아오거나, 댓글의 타임스탬프를 모아 빠르게 이동할 수 있습니다.

### 주요 기능

**🎬 핵심 구간 클리핑 (Q / E)**
- 영상 보면서 Q 를 눌러 시작점, E 를 눌러 종료점 표시
- 사이드패널 헤더의 [클립 시작] / [클립 종료] 버튼으로도 가능
- 저장된 클립에 메모 추가, 한 번 클릭으로 그 시점으로 seek

**📝 자막 추출**
- 영상의 자막을 한 번에 텍스트 list 로 추출
- 쇼츠 스타일 변환 옵션 (글자수 제한으로 자동 분할)
- TXT / SRT 포맷으로 다운로드

**🕒 댓글 타임스탬프 자동 수집**
- 영상 설명과 댓글에서 `0:00` 같은 시간 표시를 자동 분석
- 시청자가 표시한 핵심 구간을 한 list 로 보고 바로 이동

**📊 영상별 통계 + 자료 저장**
- 영상마다 자막 줄 수 · 댓글 시간 수 · 저장 클립 수 한눈에
- 모든 자료가 영상별로 분리 저장되어 나중에 다시 열어도 그대로

**💾 다양한 포맷 Export**
- 스크립트 TXT (자막 본문)
- 스크립트 SRT (자막 파일 형식)
- 타임라인 TXT (설명·댓글 시간)
- 클립 TXT (저장한 클립 목록)
- 전체 JSON (영상별 모든 자료 백업)

**🌐 한국어 / 영어**
- 사이드패널 헤더에서 KO / EN 즉시 토글
- 모든 UI 한국어 기본, 영어 전환 시 데이터 그대로 유지

### 프라이버시

- 데이터는 **사용자 브라우저에만 저장됩니다** (Chrome 의 `storage.local`)
- 외부 서버로 자료 전송 없음, 계정/로그인 필요 없음
- 분석 SDK · 광고 네트워크 · 트래커 없음

### 권한 사용 근거

- **storage**: 영상별 자막·클립·하이라이트을 로컬에 저장 (사용자 브라우저 한정)
- **sidePanel**: Chrome 사이드패널에 UI 표시
- **downloads**: TXT/SRT/JSON Export 파일 다운로드
- **activeTab**: 현재 보고 있는 유튜브 탭의 영상 정보 조회
- **scripting**: 유튜브 페이지의 player API 에서 정확한 영상 메타데이터 추출 (DOM 휴리스틱이 SPA navigation 에서 stale 데이터를 주는 문제 회피)
- **host_permissions (`https://www.youtube.com/*`)**: youtube.com 페이지에서만 작동 (다른 사이트 접근 안 함)

### 사용 방법

1. Chrome 확장 설치
2. 유튜브 영상 페이지 (`youtube.com/watch?v=...`) 열기
3. Chrome 우상단의 사이드패널 아이콘 또는 확장 아이콘 클릭
4. 영상 시청 중 Q/E 로 클립, [타임라인] 탭에서 자막·댓글 시간 분석
5. [Export] 탭에서 원하는 포맷으로 다운로드

### 제한 사항

- **롱폼 동영상** (`/watch` 페이지) 만 지원 — 쇼츠 (`/shorts`) 는 비활성화
- 자막 추출은 영상에 자막이 있는 경우만 가능 (자동 생성 자막 포함)
- 댓글 타임스탬프 분석은 댓글 영역이 먼저 로딩된 후 동작

### 도움이 되셨다면

이 확장은 **무료** 이고 **데이터를 외부로 보내지 않습니다**. 후원으로 응원해 주시면 AI 자막 요약, 자동 하이라이트 같은 새 기능 개발에 큰 힘이 됩니다.

- ☕ Buy Me a Coffee: https://buymeacoffee.com/addios4u
- 🤝 GitHub Sponsors: https://github.com/sponsors/addios4u

### 변경 사항

**v0.1.0** (초기 출시)
- 자막 추출 (스크립트 TXT/SRT)
- 댓글 타임스탬프 자동 수집
- Q/E 단축키 클립 + 메모
- 영상별 자료 분리 저장 + 통계 카드
- KO/EN i18n
- TXT/SRT/JSON Export

### 피드백 / 버그 신고

E-mail: [email protected]