영상으로 보기
YouTube 업로드에는 Google OAuth2 인증이 필요합니다. 인증을 위해 먼저 client_secret.json 파일을 준비해야 합니다.
필요한 파일
client_secret.json — Google Cloud Console에서 발급받습니다.
설정 단계
- Google Cloud Console에서 프로젝트 생성
- YouTube Data API v3 활성화
- OAuth 2.0 클라이언트 ID 생성 (애플리케이션 유형: 데스크톱 앱)
client_secret.json다운로드- 앱에서 "➕ 채널 추가" 클릭 →
client_secret.json파일 선택 → 채널 이름 입력 - 브라우저에서 Google 로그인 → YouTube 권한 승인
승인이 완료되면 토큰이 data/youtube_uploader/youtube_tokens/에 자동 저장됩니다. 이후에는 별도 로그인 없이 업로드가 가능합니다.
멀티 채널 관리
여러 YouTube 채널을 등록하고 업로드 시 채널을 선택할 수 있습니다.
| 버튼 | 기능 |
|---|---|
| ➕ 채널 추가 | 새 YouTube 채널을 OAuth 인증으로 등록합니다. |
| 🗑️ 채널 삭제 | 등록된 채널과 토큰 파일을 삭제합니다. |
| 🔄 재인증 | 토큰 만료 시 해당 채널을 다시 인증합니다. |
주의:
client_secret.json은 민감한 파일입니다. 다른 사람과 공유하지 마세요.
에피소드 선택
생성이 완료된 에피소드가 드롭다운 목록에 자동으로 표시됩니다. 이미 업로드된 에피소드는 ✅, 아직 업로드하지 않은 에피소드는 ⬜로 구분됩니다.
에피소드를 선택하면 output/{에피소드명}/ 폴더에서 영상 파일(*_final*.mp4)이 자동으로 감지됩니다.
메타데이터
메타데이터 생성 단계에서 만들어진 파일이 자동으로 로드됩니다. 직접 편집도 가능합니다.
| 항목 | 설명 | 소스 파일 |
|---|---|---|
| 제목 | 메타데이터 생성에서 만든 제목이 자동 입력됩니다. 직접 편집하거나 목록에서 선택할 수 있습니다. | youtube_titles.txt |
| 설명 | 타임스탬프가 포함된 설명문이 자동 생성됩니다. | youtube_description.txt |
| 태그 | 쉼표로 구분된 키워드 목록입니다. | youtube_tags.txt |
| 카테고리 | 15개 YouTube 카테고리 중 선택합니다. (기본: 뉴스/정치) | — |
팁: 롱폼/쇼츠 제작 시 메타데이터 생성 단계를 실행하면 SEO에 최적화된 제목·설명·태그가 자동으로 만들어져 업로드 탭에 바로 반영됩니다.
공개 설정
| 설정 | 설명 |
|---|---|
| 🌍 공개 (기본) | 즉시 모든 사용자에게 공개됩니다. |
| 🔗 일부공개 | 링크를 아는 사람만 시청할 수 있습니다. |
| 🔒 비공개 | 본인만 시청할 수 있습니다. |
예약 업로드
"📅 예약 업로드" 체크박스를 활성화하면 날짜와 시간을 지정하여 영상이 자동으로 공개되도록 예약할 수 있습니다.
- 기본값: 현재 시간 + 1시간 후
- 예약 활성화 시 공개 설정이 자동으로 비공개로 전환됩니다. (YouTube API 요구사항)
- 예약된 시간이 되면 YouTube에서 자동으로 공개 처리합니다.
추가 옵션
- ✅ 업로드 후 브라우저 열기 (기본: 켜짐) — 업로드 완료 시 브라우저에서 YouTube 영상 페이지를 자동으로 엽니다.
업로드 확인: 업로드 버튼 클릭 시 채널명, 제목, 공개 설정, 썸네일 정보를 확인하는 대화상자가 표시됩니다.
썸네일은 영상의 첫인상을 결정하는 중요한 요소입니다.
자동 감지
에피소드 폴더에서 아래 이름의 이미지 파일이 있으면 자동으로 선택됩니다.
thumbnail.jpg,thumbnail.pngthumb.jpg,thumb.png썸네일.jpg,썸네일.png
수동 설정
- "📁 찾아보기" 버튼으로 원하는 이미지 파일을 직접 선택할 수 있습니다.
- "❌ 제거" 버튼으로 선택한 썸네일을 해제할 수 있습니다.
자동 압축
YouTube 썸네일은 2MB 이하여야 합니다. 초과 시 자동으로 JPEG 압축이 적용됩니다.
- JPEG 품질 단계적 감소 (85% → 70% → 50% → 30%)
- 품질 감소로 부족하면 이미지 크기 축소 (80% → 60% → 40% → 30%)
권장 해상도: 1280x720 (JPG 또는 PNG)
참고: 2MB를 초과하는 썸네일은 자동으로 압축되므로 별도 작업이 필요 없습니다.
- 업로드된 영상은 자동으로 이력에 기록됩니다. (YouTube URL, 업로드 시간, 제목 포함)
- 에피소드 목록에서 업로드 완료된 항목은 ✅로 표시됩니다.
- 같은 에피소드를 중복 업로드하려 하면 경고가 표시됩니다.
- 이력 데이터는
data/youtube_uploader/upload_history.json에 저장됩니다.
완료 알림
- 업로드 성공 시 완료 알림음과 함께 YouTube URL이 표시됩니다.
- 실패 시 오류 알림음과 상세 에러 로그가 표시됩니다.
- 로그는 "💾 로그 저장" 버튼으로 텍스트 파일로 저장할 수 있습니다.