SumTube - YouTube 영상 AI 요약 프로그램

SumTube는 YouTube 영상의 자막/스크립트를 추출하고 Ollama의 AI 모델을 사용하여 한국어로 상세한 요약을 생성하는 포터블 애플리케이션입니다.

✨ 주요 기능

• 🎬 YouTube 스크립트 추출: yt-dlp를 사용하여 자막/스크립트 자동 추출
• 🤖 AI 기반 요약: Ollama AI 모델로 상세한 한국어 요약 생성
• 📝 다단계 요약 모드: 일반/상세/초상세 요약 지원
• 📦 완전한 포터블: 시스템 종속성 없이 독립 실행 가능
• 🔄 자동 업데이트: 실행 시마다 yt-dlp와 Ollama 최신 버전 확인 및 업데이트
• 🌐 다국어 자막 지원: 한국어, 영어, 자동 생성 자막 지원
• ⚙️ 설정 파일 지원: 모든 설정을 JSON 파일로 쉽게 커스터마이징
• 🚀 향상된 다운로드 진행률: 속도, ETA, 진행바가 포함된 실시간 진행률 표시
• 🎯 명령줄 모델 선택: 원하는 AI 모델을 명령줄에서 직접 지정 가능
• 🔐 고급 모델 검증: 모델 무결성 검증 및 자동 재다운로드 기능
• 🐛 디버그 모드: 상세한 로그 출력으로 문제 진단 지원

🚀 사용법

기본 사용법SumTube.exe --url "https://www.youtube.com/watch?v=VIDEO_ID"

상세 요약 모드 (기본보다 2-3배 길고 포괄적인 요약)SumTube.exe --url "https://www.youtube.com/watch?v=VIDEO_ID" --detailed

한국어 옵션으로 상세 요약SumTube.exe --url "https://www.youtube.com/watch?v=VIDEO_ID" --상세히

커스텀 모델 + 상세 요약SumTube.exe --url "https://www.youtube.com/watch?v=VIDEO_ID" --model "llama3.1:8b" --detailed

모든 옵션 조합SumTube.exe --url "https://www.youtube.com/watch?v=VIDEO_ID" --model "gemma2:9b" --detailed --debug

단축 옵션SumTube.exe -u "https://www.youtube.com/watch?v=VIDEO_ID" -m "gemma2:9b" --상세히 -d

명령줄 옵션

옵션	단축	설명	필수
--url	-u	YouTube 영상 URL	✅
--model	-m	사용할 AI 모델 이름	❌
--detailed	--상세히	매우 상세한 요약 생성 (2-3배 길고 포괄적)	❌
--debug	-d	디버그 모드 활성화	❌

📝 요약 모드 비교

🟢 일반 모드 (기본값)

• 용도: 빠른 개요 파악
• 길이: 보통 (1-2 페이지)
• 내용: 핵심 주제, 주요 내용, 포인트, 결론
• 소요시간: 짧음 (30초-1분)

🔵 상세 모드 (--detailed 또는 --상세히)

• 용도: 심화 학습 및 완전한 이해
• 길이: 길음 (3-5 페이지)
• 내용:
  • 📊 영상 개요 및 구성
  • 🔹 단계별 핵심 논점 (최대 3-4개)
  • 📈 데이터 및 통계 정보
  • 💭 시사점 및 개인적 견해
  • 🔗 관련 정보 및 확장 학습
• 소요시간: 김 (1-3분)
• 특징:
  • 모든 세부사항과 예시 포함
  • 실용적인 actionable insights 제공
  • 배경 정보와 관련 맥락 설명
  • 구체적인 수치와 데이터 포함

상세 모드 요약 구조## 📌 영상 초성세 요약

🎯 핵심 주제 및 배경

[상세한 배경 맥락 (5-7문장)]

📊 영상 개요 및 구성

[전체적인 구성과 발표자 정보]

📋 상세 주요 내용

🔹 도입부 및 문제 제기

🔹 핵심 논점 1

🔹 핵심 논점 2

🔹 핵심 논점 3

🔹 추가 논점들

💡 핵심 포인트 및 중요 개념

📈 데이터 및 통계 정보

🎯 결론 및 종합 분석

💭 시사점 및 개인적 견해

🔗 관련 정보 및 확장 학습

사용 가능한 모델 예시

• exaone3.5:7.8b (기본값)
• llama3.1:8b
• llama3.1:70b
• gemma2:9b
• qwen2:7b
• codellama:7b

🐛 디버그 모드

디버그 모드를 활성화하면 상세한 내부 작업 로그를 확인할 수 있습니다.

디버그 모드 활성화SumTube.exe --url "URL" --debug

디버그 로그 정보

• 타임스탬프: 각 작업의 정확한 시간
• 카테고리별 로그: STARTUP, RUNTIME, OLLAMA, MODEL, API, YOUTUBE, AI 등
• 성능 메트릭: 각 작업의 소요 시간 및 상세 정보
• 요약 모드 추적: 일반/상세 모드 구분 및 처리 과정 로깅

📁 디렉토리 구조

SumTube/ ├── SumTube.exe ├── appsettings.json # 설정 파일 ├── runtime/ # 포터블 런타임 환경 │ ├── python/ # 임베디드 Python 환경 │ ├── ollama/ # 포터블 Ollama 환경 │ └── versions.json # 버전 정보 캐시 └── ...

⚙️ 설정 파일 (appsettings.json)

AI 모델 설정{

"Ollama": { "Port": 11435, "DefaultModel": "exaone3.5:7.8b", "ApiOptions": { "Temperature": 0.3, "TopP": 0.9, "MaxTokens": 4096 } } }

YouTube 처리 설정{

"YouTube": { "SubtitleLanguagePriority": ["ko", "en", "en.*"], "MaxTranscriptLength": 150000 } }

🔧 시스템 요구사항

• 운영체제: Windows 10/11 (64-bit)
• 프레임워크: .NET 10 (자동 설치됨)
• 메모리: 최소 4GB RAM (AI 모델 로딩용)
• 디스크: 최소 10GB 여유 공간
• 네트워크: 인터넷 연결 (초기 설정 및 업데이트용)

🎯 첫 실행 시 자동 구성

첫 실행 시 다음이 자동으로 다운로드되고 구성됩니다:

1. Python 3.12 임베디드 버전 (~25MB)
2. yt-dlp 최신 버전 (~3MB)
3. Ollama 최신 버전 (~500MB)
4. 지정된 AI 모델 (크기는 모델에 따라 다름)

⏱️ 첫 실행은 선택한 모델과 인터넷 속도에 따라 10-30분 정도 소요될 수 있습니다.

🛠️ 문제 해결

자막을 찾을 수 없는 경우⚠️ 자막을 찾을 수 없습니다.- 해당 영상에 자막이 없거나 비공개 상태일 수 있습니다

디버그 모드 활용

문제 발생 시:SumTube.exe --url "YOUR_URL" --debug- 상세한 오류 정보 확인

• 각 단계별 진행 상황 추적
• 요약 모드별 성능 분석

📝 라이선스

이 프로젝트는 개인 및 교육 목적으로 자유롭게 사용할 수 있습니다.

🙏 감사의 말

• yt-dlp: YouTube 영상 다운로드 및 정보 추출
• Ollama: 로컬 AI 모델 실행 환경
• LG AI Research: exaone3.5 모델 개발

---

SumTube - YouTube 영상을 더 스마트하게 소비하세요! 🎬✨