{"skill":{"slug":"tube-summary","displayName":"tube-summary","summary":"Search YouTube videos on any topic, extract English subtitles, and generate detailed summaries with key topics, quotes, and timestamps.","description":"---\nname: tube-summary\ndescription: Search YouTube for videos on any topic and get intelligent summaries from video subtitles. Use when you need to: (1) Find and preview YouTube videos on a subject, (2) Get a detailed description of what a video covers based on its actual content, (3) Quickly understand video topics without watching. Workflow: search YouTube → pick a video → extract and summarize subtitles.\n---\n\n# tube-summary\n\nSearch YouTube for videos on any topic, then extract and summarize their content using subtitles.\n\n## Quick Start\n\n### Step 1: Search for Videos\n\nWhen asked about a topic, search YouTube and list the top 10 results:\n\n```bash\npython3 scripts/youtube-search.py \"your search query\"\n```\n\nThis returns a numbered list of videos with titles, channels, and view counts.\n\n### Step 2: User Picks a Video\n\nThe user selects one video by number (e.g., \"3\" for the third video).\n\n### Step 3: Download Subtitles\n\nExtract English subtitles from the selected video using yt-dlp:\n\n```bash\nyt-dlp --write-subs --sub-langs en --skip-download \"VIDEO_URL\"\n```\n\nThis creates a `.en.vtt` subtitle file without downloading the video.\n\n### Step 4: Process & Summarize\n\nUse the subtitle processor to analyze and summarize:\n\n```bash\npython3 scripts/process-subtitles.py \"path/to/subtitle-file.vtt\"\n```\n\nThis generates:\n- **Key Topics**: Main subjects covered in the video\n- **Summary**: Concise 2-3 paragraph description of content\n- **Timestamps**: Notable moments with context\n- **Key Quotes**: Important statements from speakers\n\n## Workflow\n\n1. **Search** → `youtube-search.py \"<topic>\"` → Display top 10 videos\n2. **User selects** → e.g., \"Video 5\"\n3. **Extract URL** → From the search results\n4. **Download subs** → `yt-dlp --write-subs --sub-langs en --skip-download \"URL\"`\n5. **Process** → `process-subtitles.py \"subtitle.vtt\"`\n6. **Present** → Formatted summary with key points\n\n## Prerequisites\n\n- `yt-dlp` (install: `pip install yt-dlp`)\n- `requests` (for YouTube search fallback)\n- Python 3.7+\n\n## Notes\n\n- If YouTube search API is unavailable, the fallback uses web scraping via requests\n- Subtitles may be auto-generated if not manually authored\n- Some videos may not have English subtitles available\n- The subtitle file is created in the same directory as yt-dlp is run\n\n## Example Usage\n\n```\nUser: \"Tell me about Rust programming language\"\n\n→ Search returns 10 videos about Rust\n\nUser: \"Summarize video 3\"\n\n→ Downloads subtitles from video 3\n→ Processes and returns detailed summary\n```\n","tags":{"latest":"1.0.0"},"stats":{"comments":1,"downloads":2928,"installsAllTime":7,"installsCurrent":7,"stars":2,"versions":1},"createdAt":1769653406198,"updatedAt":1778485867301},"latestVersion":{"version":"1.0.0","createdAt":1769653406198,"changelog":"Search YouTube videos and extract/summarize subtitles for any topic. Workflow: search → pick video → download subs → analyze and provide key topics, summary, quotes, and notable moments.","license":null},"metadata":null,"owner":{"handle":"dillera","userId":"s174tw5f1qfbez5j22c9zgw905885e5j","displayName":"dillera","image":"https://avatars.githubusercontent.com/u/123479?v=4"},"moderation":null}