youtube-transcript-skill

KO | EN

gitlite — search

#hacktoberfest #ai #llm #docker #macos #java #windows #awesome-list #pytorch #security #mcp #openai #ios #open-source

youtube-transcript-skill

(★ 9)

YouTube Transcript Skill v2.0 - Download, Translate to Vietnamese, Summarize. Perfect for learning English from YouTube and building personal knowledge base.

youtube-transcript-skill Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# YouTube Transcript Skill v2.0

![YouTube Transcript Skill](https://img.shields.io/badge/YouTube-Transcript-Skill-blue?style=for-the-badge&logo=youtube)
![Python 3.9+](https://img.shields.io/badge/Python-3.9+-green?style=for-the-badge&logo=python)
![License: MIT](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)
![Version: 2.0.0](https://img.shields.io/badge/Version-2.0.0-orange?style=for-the-badge)

**Automated YouTube Transcript Downloader with Vietnamese Translation & AI Summarization**

[English](#english) | [Tiếng Việt](#tiếng-việt)

</div>

---

## 🎯 What is YouTube Transcript Skill?

A powerful CLI tool that automatically **downloads → translates → summarizes** YouTube video transcripts. Perfect for:

- 📚 **Learning English** from YouTube videos
- 🧠 **Building personal knowledge base**
- 🔬 **Research & Study** - extract insights from video content
- 💼 **Work training** - save tutorial videos for later reference

### The Problem

```
❌ Video tiếng Anh nhiều, khó hiểu
❌ Copy transcript thủ công tốn thời gian  
❌ Phụ thuộc vào AI bên ngoài (ChatGPT, NotebookLM)
❌ Khó tổ chức và quản lý dữ liệu học tập
```

### The Solution

```
✅ Tự động bóc tách transcript từ YouTube URL
✅ Dịch sang tiếng Việt (--translate)
✅ Tóm tắt + phân tích cấu trúc (--summarize)
✅ Lưu cục bộ theo cấu trúc folder chủ đề
✅ Không phụ thuộc vào AI cloud
```

---

## ✨ Features

| Feature | Description | Command |
|---------|-------------|---------|
| 📥 **Download** | Get original transcript (EN/VI) | `-l en` or `-l vi` |
| 🌐 **Translate** | Auto-translate to Vietnamese | `--translate` |
| 📝 **Summarize** | Generate summary + insights | `--summarize` |
| 💾 **Save Local** | Organized by topic folders | `-o path` |

---

## 🚀 Quick Start

### Installation

```bash
# Clone the repository
git clone https://github.com/nguyenngothuong/youtube-transcript-skill.git
cd youtube-transcript-skill

# Install dependencies
pip install -r requirements.txt
```

### Basic Usage (Download Only)

```bash
# Download English transcript
python scripts/yt_transcript.py "https://www.youtube.com/watch?v=VIDEO_ID"

# Download Vietnamese transcript
python scripts/yt_transcript.py "https://www.youtube.com/watch?v=VIDEO_ID" -l vi
```

### With Translation (Download + Vietnamese)

```bash
python scripts/yt_transcript.py "URL" --translate
```

### Full Pipeline (Download + Translate + Summarize)

```bash
python scripts/yt_transcript.py "URL" --translate --summarize \
    -o "./output/my-learning-topic"
```

---

## 📖 Usage Examples

### Example 1: Learning English from Tech Videos

```bash
# Download + Translate + Summarize an AI/ML tutorial
python scripts/yt_transcript.py "https://www.youtube.com/watch?v=aircAruvnKk" \
    --translate \
    --summarize \
    -o "~/learning/ai/machine-learning"
```

**Output:**
```
~/learning/ai/machine-learning/
├── backpropagation_algorithm.md          # Original transcript (EN)
├── backpropagation_algorithm_vi.txt      # Vietnamese translation
├── backpropagation_algorithm_summary.md  # Summary + insights
└── backpropagation_algorithm_metadata.json
```

### Example 2: Building Knowledge Base

```bash
# Create a course folder and download multiple videos
mkdir -p "~/learning/programming/python-fundamentals"

# Download each video in the course
python scripts/yt_transcript.py "URL_VIDEO_1" \
    --translate --summarize \
    -o "~/learning/programming/python-fundamentals"

python scripts/yt_transcript.py "URL_VIDEO_2" \
    --translate --summarize \
    -o "~/learning/programming/python-fundamentals"
```

### Example 3: Quick Reference for Work Training

```bash
# Download a tutorial video for work
python scripts/yt_transcript.py "https://www.youtube.com/watch?v=VIDEO_ID" \
    --translate \
    -o "~/work-training/notion-tutorial"
```

---

## 📂 Output Structure

```
{output_dir}/
├── {video_title}.txt              # Original transcript with timestamps
├── {video_title}_vi.txt           # Vietnamese translation
├── {video_title}_summary.md       # Summary + key insights
└── {video_title}_metadata.json    # Video metadata
```

### Sample Summary Output (`_summary.md`)

```markdown
# What is Neural Networks? - Summary

**Channel:** 3Blue1Brown
**Link:** https://youtube.com/watch?v=aircAruvnKk
**Word count:** ~3,500 words

---

## Overview
[First 300 characters of transcript...]

## Key Points
1. Neural networks are computing systems...
2. The basic structure consists of...
3. Backpropagation is the key algorithm...

## Insights
- Video has step-by-step explanations
- Contains important formulas and diagrams
- Total words: ~3,500

## Next Steps
- Read original transcript for deeper understanding
- Practice the concepts mentioned
- Save to knowledge base for future reference
```

---

## 🔧 Command Line Options

```
python yt_transcript.py <youtube_url> [options]

Options:
    -l, --lang         Language: en, vi, en-orig, vi-orig (default: en)
    -o, --output       Output directory (default: ./transcripts)
    -t, --translate    Translate transcript to Vietnamese
    -s, --summarize    Generate summary + analysis
    -f, --format       Format: txt, vtt, both (default: txt)
    -k, --keep-vtt     Keep VTT file after conversion
    -h, --help         Show help message
```

---

## 📊 Comparison with Other Tools

| Feature | **YouTube Transcript Skill** | ChatGPT | NotebookLM |
|---------|------------------------------|---------|------------|
| **Data Storage** | Local (your control) | Cloud | Cloud |
| **Organization** | Topic folders | Hard to organize | Hard to organize |
| **Dependencies** | None | OpenAI API | Google |
| **Vietnamese Translation** | ✅ Automatic | ✅ Paid | ❌ No |
| **Summary** | ✅ Structured | ✅ | ✅ |
| **Cost** | Free | Pay per token | Paid |
| **Customization** | High | Medium | Low |

### Why Choose YouTube Transcript Skill?

1. **✅ You own your data** - No vendor lock-in
2. **✅ Completely free** - No API costs
3. **✅ Organized structure** - Topic-based folders
4. **✅ Vietnamese support** - Built-in translation
5. **✅ Works offline** - After initial download

---

## 🎓 Use Cases

### For English Learning

- 📖 Read transcripts instead of watching videos
- 🌐 Read Vietnamese translation for quick understanding
- 📝 Compare EN-VI to learn vocabulary & grammar
- 🎧 Use transcripts for listening practice

### For Personal Knowledge Management

- 📚 Build a library of learning materials
- 🔍 Find content later with organized folders
- 📊 Generate summaries for quick review
- 🔄 Never lose access to your notes

### For Research & Study

- 📑 Extract key points from long videos
- 🎯 Focus on insights, skip filler content
- 📋 Create study notes automatically
- 💾 Reference content later without re-watching

---

## 📦 Requirements

### Basic (Download Only)
- Python 3.9+
- yt-dlp (auto-installed if missing)
- Internet connection

### With Translation
- `deep-translator` or `googletrans`

### With Summarization
- Built-in rule-based summarization (no API needed)
- For AI summarization: langchain (optional)

```bash
# Install all dependencies
pip install yt-dlp deep-translator
```

---

## 🛠️ Troubleshooting

### No Subtitles Available

```bash
# Try different language
python yt_transcript.py "URL" -l vi

# Try original subtitles (higher quality)
python yt_transcript.py "URL" -l en-orig
```

### yt-dlp Errors

```bash
# Update yt-dlp
pip install --upgrade yt-dlp
```

### Translation Issues

```bash
# Install deep-translator
pip install deep-translator

# Or use googletrans (fallback)
pip install googletrans==4.0.0-rc1
```

---

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

---

## 📚 Recommended YouTube Channels

Great channels to practice with:

**AI & Machine Learning:**
- 3Blue1Brown
- Andrew Ng's DeepLearning.AI
- MIT OpenCourseWare

**Programming:**
- Traversy Media
- Fireship
- FreeCodeCamp

**Productivity & Learning:**
- Thomas Frank
- Ali Abdaal
- Matt D'Avella

---

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

---

## 👨‍💻 Author

**Nguyen Ngo Thuong** - [Diginno](https://diginno.net)

- 🌐 Website: https://diginno.net
- 📧 Email: contact@diginno.net
- 📱 Phone: 0816226086

---

## 🙏 Acknowledgments

- [yt-dlp](https://github.com/yt-dlp/yt-dlp) - YouTube downloader
- [deep-translator](https://github.com/nidhaloff/deep-translator) - Translation library
- [Claude Code](https://claude.com/claude-code) - AI coding assistant

---

**⭐ Star this repo if you find it useful!**

Made with ❤️ by [Diginno](https://diginno.net)

</div>

---

## English

### What is YouTube Transcript Skill?

A CLI tool that automatically downloads YouTube video transcripts, translates them to Vietnamese, and generates summaries for efficient learning and knowledge management.

### Key Features

- **Download** transcripts from any YouTube video
- **Translate** to Vietnamese automatically
- **Summarize** with key insights and structure
- **Save locally** with organized folder structure

### Get Started

```bash
git clone https://github.com/nguyenngothuong/youtube-transcript-skill.git
cd youtube-transcript-skill
pip install -r requirements.txt

# Download + Translate + Summarize
python scripts/yt_transcript.py "URL" --translate --summarize
```

---

## Tiếng Việt

### YouTube Transcript Skill là gì?

Công cụ CLI tự động tải transcript video YouTube, dịch sang tiếng Việt, và tạo tóm tắt để học tập và quản lý kiến thức hiệu quả.

### Tính năng chính

- **📥 Tải** transcript từ bất kỳ video YouTube nào
- **🌐 Dịch** sang tiếng Việt tự động
- **📝 Tóm tắt** với các điểm chính và cấu trúc
- **💾 Lưu cục bộ** với cấu trúc folder theo chủ đề

### Bắt đầu

```bash
git clone https://github.com/nguyenngothuong/youtube-transcript-skill.git
cd youtube-transcript-skill
pip install -r requirements.txt

# Tải + Dịch + Tóm tắt
python scripts/yt_transcript.py "URL" --translate --summarize
```

### Lợi ích

1. **Chủ động kiểm soát dữ liệu** - Không lo mất dữ liệu khi service đổi chính sách
2. **Không phụ thuộc** - Dùng offline được sau khi tải
3. **Tổ chức khoa học** - Folder theo chủ đề, dễ tìm
4. **Miễn phí** - Không tốn chi phí API

### Liên hệ

- 🌐 Website: https://diginno.net
- 📧 Email: contact@diginno.net
- 📱 Điện thoại: 0816226086

youtube-transcript-skill

youtube-transcript-skill Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

youtube-transcript-skill

youtube-transcript-skill Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README