---
author: "Mukul Chugh"
canonical: "https://mukulchugh.com/projects/ctxr"
description: "Turn YouTube videos into agent-readable context: transcripts, keyframes, and timestamped Markdown walkthroughs, available through a CLI and MCP server."
image: "https://mukulchugh.com/og/projects/ctxr.png"
language: "en"
title: "ctxr"
type: "project"
---

# ctxr

Turn YouTube videos into agent-readable context: transcripts, keyframes, and timestamped Markdown walkthroughs, available through a CLI and MCP server.

## Technology

Python, AI Agents, MCP, Video, Open Source

## Give agents the context inside a video.

Useful product knowledge often lives in demos, tutorials, and talks. A transcript alone loses the interface being shown; isolated screenshots lose the explanation. ctxr aligns the two into material an agent can read.

## How it works

- Choose a YouTube video, playlist, or page of embedded videos
- Extract captions or a local transcript and representative keyframes
- Read or query timestamped walkthroughs through the CLI and MCP server

## Implementation

The public README describes a Python pipeline using yt-dlp for downloads, ffmpeg for scene-based frame extraction, and captions with optional local Whisper transcription. Transcript segments are aligned to frames and written as Markdown and structured manifests. An MCP server exposes processing and focused queries over the output.

## Scope and boundaries

Repository documentation reviewed, not independently runtime-tested. YouTube is the documented source platform. Automatic transcripts can mishear names, and source availability and rate limits affect processing. No accuracy or throughput guarantee is claimed.

## Sources

- <https://github.com/mukulchugh/ctxr>

[Repository](https://github.com/mukulchugh/ctxr)

---

[View this page](https://mukulchugh.com/projects/ctxr) · [Site index](https://mukulchugh.com/llms.txt)