Guides on Ghafoor's Personal Blog

Video-to-Vocabulary Workflow - How To Guide

noreply@example.com (AG Sayyed) — Tue, 05 May 2026 00:00:00 +0000

Video-to-Vocabulary: Practical How-To Guide

🎯 Quick Overview

This guide shows you how to automatically extract difficult English vocabulary from videos (YouTube, courses, etc.) and create dictionary entries with Urdu translations.

📋 Prerequisites

1. Install Required Tools

1# Create Python virtual environment
2cd scripts/dictionary
3python3 -m venv .venv
4source .venv/bin/activate # On Linux/Mac
5# .venv\Scripts\activate # On Windows
6
7# Install dependencies
8pip install youtube-transcript-api openai pyyaml nltk wordfreq

2. Get API Keys

OpenAI API Key (for GPT-4): https://platform.openai.com/api-keys
YouTube API Key (optional, for metadata): https://console.cloud.google.com/

3. Configure Environment

1# Create .env file in scripts/dictionary/
2cat > scripts/dictionary/.env << EOF
3OPENAI_API_KEY=your_key_here
4YOUTUBE_API_KEY=your_key_here # Optional
5EOF

🚀 Method 1: Using GitHub Copilot Chat (Simplest)

Step 1: Get Video Transcript

1# In terminal or use the provided script
2youtube-transcript-api VIDEO_ID > transcript.txt

Step 2: Use Copilot Prompt

I have a video transcript about [TOPIC]. Please:

1. Read this transcript and identify 20-30 difficult English words that would be challenging for an advanced learner
2. For each word provide:
 - The word
 - Part of speech
 - A simple English definition
 - The sentence from the transcript where it appears
 - An Urdu translation of the word
 - An Urdu translation of the example sentence
3. Format the output as YAML following this structure:

[Paste your YAML template here]

Transcript:
[Paste transcript here]

Step 3: Review & Save

Copy the generated YAML
Paste into data/dictionary/[topic]/vocabulary.yaml
Review and edit as needed

🤖 Method 2: Using Python Script (Automated)

Basic Usage

1# From your blog root directory
2python scripts/dictionary/extract_vocabulary.py \
3 --video-url "https://youtube.com/watch?v=dQw4w9WgXcQ" \
4 --topic "rag-course" \
5 --output-dir data/dictionary/rag-course/

What It Does

✅ Fetches video transcript from YouTube
✅ Uses GPT-4 to identify difficult words
✅ Translates to Urdu using AI
✅ Generates example sentences
✅ Creates properly formatted YAML file
✅ Optionally creates Hugo content page

Advanced Options

 1# Control number of words
 2python scripts/dictionary/extract_vocabulary.py \
 3 --video-url "URL" \
 4 --max-words 30 \
 5 --difficulty-threshold 7
 6
 7# Interactive review mode
 8python scripts/dictionary/extract_vocabulary.py \
 9 --video-url "URL" \
10 --interactive
11
12# Create complete Hugo page
13python scripts/dictionary/extract_vocabulary.py \
14 --video-url "URL" \
15 --topic "my-course" \
16 --create-hugo-page

📝 Method 3: Manual with AI Assistance

Step 1: Get Transcript

For YouTube:

Copilot Prompt Template

noreply@example.com (AG Sayyed) — Mon, 01 Jan 0001 00:00:00 +0000

I need help extracting vocabulary from a video transcript for my English learning dictionary.

Task: Analyze this video transcript about [topic] and extract 25 challenging English words suitable for an advanced ESL learner (first language: Urdu).

Selection Criteria:

Difficulty level: 7-9 out of 10
Important for understanding economics/politics/social systems
Not common everyday words
Academic, intellectual, or domain-specific terms
Useful for understanding the [topic] in depth

For each word, provide:

word: the English word (lowercase)
part_of_speech: (noun, verb, adjective, adverb, phrase, technical-term, etc.)
urdu_meaning: Urdu translation in Urdu script
example_en: A clear example sentence from the transcript or similar context
example_ur: Natural, contextual Urdu translation of the example
additional_example_ur: (optional) Another Urdu example showing different usage

Output Format: Valid YAML array only, no markdown code fences, no explanations.

Dictionary System - Quick Reference

noreply@example.com (AG Sayyed) — Mon, 01 Jan 0001 00:00:00 +0000

Dictionary Quick Reference Card

🚀 Quick Start

Create New Topic

1# 1. Create content page
2hugo new content/docs/dictionary/[topic-name]/index.md --kind dictionary
3
4# 2. Create data file
5mkdir -p data/dictionary/[topic-name]
6touch data/dictionary/[topic-name]/vocabulary.yaml
7
8# 3. Edit content page and update shortcode reference
9# 4. Add vocabulary entries to YAML file

📝 YAML Entry Template

1- word: example
2 part_of_speech: noun
3 urdu_meaning: مثال
4 example_en: This is an example sentence.
5 example_ur: یہ ایک مثالی جملہ ہے۔
6 additional_example_ur: مزید مثال (optional)

Note: Tags are handled in the page frontmatter, not in individual vocabulary entries.