tube-summary

Search YouTube for videos on any topic, then extract and summarize their content using subtitles.

Quick Start

Step 1: Search for Videos

When asked about a topic, search YouTube and list the top 10 results:

CODEBLOCK0

This returns a numbered list of videos with titles, channels, and view counts.

Step 2: User Picks a Video

The user selects one video by number (e.g., "3" for the third video).

Step 3: Download Subtitles

Extract English subtitles from the selected video using yt-dlp:

CODEBLOCK1

This creates a .en.vtt subtitle file without downloading the video.

Step 4: Process & Summarize

Use the subtitle processor to analyze and summarize:

CODEBLOCK2

This generates:

• - Key Topics: Main subjects covered in the video
• Summary: Concise 2-3 paragraph description of content
• Timestamps: Notable moments with context
• Key Quotes: Important statements from speakers

Workflow

1. 1. Search → youtube-search.py "<topic>" → Display top 10 videos
2. User selects → e.g., "Video 5"
3. Extract URL → From the search results
4. Download subs → INLINECODE2
5. Process → INLINECODE3
6. Present → Formatted summary with key points

Prerequisites

• - yt-dlp (install: pip install yt-dlp)
• INLINECODE6 (for YouTube search fallback)
• Python 3.7+

Notes

• - If YouTube search API is unavailable, the fallback uses web scraping via requests
• Subtitles may be auto-generated if not manually authored
• Some videos may not have English subtitles available
• The subtitle file is created in the same directory as yt-dlp is run

Example Usage

CODEBLOCK3