📦 deps(thirdparty): update snapshots

2026-06-07 16:02:11 +00:00
parent 772a1da63c
commit ac39ab52f3
219 changed files with 5905 additions and 833 deletions
@@ -0,0 +1,103 @@
+---
+name: video-content-extractor
+description: "Extract key frames from MP4 videos at configurable intervals, run Tesseract OCR, and generate structured Markdown reports with video metadata and timestamped text transcripts."
+category: media-processing
+risk: safe
+source: community
+source_repo: 274326424/video-content-extractor
+source_type: community
+date_added: "2026-06-06"
+author: 274326424
+tags: [video, ocr, ffmpeg, tesseract, frame-extraction, media]
+tools: [codex]
+---
+
+# Video Content Extractor
+
+## Overview
+
+Automatically extracts key frames from MP4 video files at configurable time intervals, performs OCR text recognition on each frame, and generates a structured Markdown report. The report includes video metadata (duration, resolution, codecs) and frame-by-frame OCR transcripts with timestamp references.
+
+This skill is designed for Codex CLI and requires FFmpeg and Tesseract OCR installed on the local machine.
+
+## When to Use This Skill
+
+- Use when you need to extract text content from video presentations, lectures, or screencasts.
+- Use when you want to create searchable transcripts from video files without embedded subtitles.
+- Use when you need to analyze video content programmatically and generate structured summaries.
+- Use when the user asks to "read what is on screen" or "extract the content from this video."
+
+## How It Works
+
+### Step 1: Analyze Video Metadata
+
+The skill uses ffprobe to extract video metadata: duration, resolution, frame rate, codec information, and file size.
+
+### Step 2: Extract Key Frames
+
+Using FFmpeg, the skill captures frames at the configured interval (default: every 30 seconds). Each frame is saved as a timestamped JPEG image.
+
+### Step 3: OCR Text Recognition
+
+Each extracted frame is processed by Tesseract OCR. If the default PSM mode returns no meaningful text, it falls back to fully automatic page segmentation.
+
+### Step 4: Generate Markdown Report
+
+All extracted data is assembled into a structured Markdown document.
+
+## Examples
+
+### Example 1: Basic Extraction
+
+Agent prompt:
+Use the video-content-extractor skill to extract content from lecture.mp4
+
+Output generates lecture.md and lecture_frames/ directory.
+
+### Example 2: Custom Interval
+
+Parameters: video_path, output_dir, interval(seconds), lang
+Extract every 60 seconds with English-only OCR:
+python scripts/extract_video.py recording.mp4 ./output 60 eng
+
+### Example 3: Bilingual Content
+
+Extract with default Chinese + English OCR:
+python scripts/extract_video.py lecture.mp4 . 15 chi_sim+eng
+
+## Best Practices
+
+- Use shorter intervals (10-15s) for fast-paced content with frequent text changes.
+- Use longer intervals (30-60s) for presentation slides or slow lectures to reduce duplicate frames.
+- For Chinese content, ensure Tesseract Chinese language pack is installed (chi_sim).
+
+## Limitations
+
+- Requires FFmpeg and Tesseract OCR to be installed and accessible via PATH.
+- Tesseract OCR accuracy depends on video quality, text size, and font clarity.
+- Does not extract audio or perform speech-to-text transcription.
+- Frame extraction is time-based (not scene-change-based), which may produce near-duplicate frames.
+- Large videos with short intervals can generate many frames - ensure sufficient disk space.
+
+## Security and Safety Notes
+
+- This skill only reads video files and writes extracted frames and Markdown reports.
+- It does NOT send any data over the network - all processing is local.
+- FFmpeg and Tesseract are invoked with fixed, pre-vetted arguments.
+- The skill does not modify or delete the original video file.
+
+## Common Pitfalls
+
+- Problem: Tesseract returns garbled text
+  Solution: Ensure the correct language pack is installed. Run tesseract --list-langs to verify.
+
+- Problem: FFmpeg fails with "not found"
+  Solution: Make sure FFmpeg is on PATH. Run ffmpeg -version to verify.
+
+- Problem: OCR is slow on large videos
+  Solution: Increase the interval parameter to reduce frames processed.
+
+## Related Skills
+
+- @media-summarizer - For summarizing video content using visual and audio cues.
+- @document-ocr - For OCR on static images or scanned documents without video processing.