# Ffmpeg Keyframe Extraction

> Extract key frames (I-frames) from video files using FFmpeg command line tool. Use this skill when the user needs to pull out keyframes, thumbnails, or important frames from MP4, MKV, AVI, or other video formats for analysis, previews, or processing.

- Skill: `bishal-pdmsft/ffmpeg-keyframe-extraction-7` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add bishal-pdmsft/ffmpeg-keyframe-extraction-7`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bishal-pdmsft/ffmpeg-keyframe-extraction-7/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: Complete terms in LICENSE.txt
- Author: bishal-pdMSFT (https://skillmd.com/u/bishal-pdmsft)
- Updated: 2026-11-15
- Page: https://skillmd.com/skills/bishal-pdmsft/ffmpeg-keyframe-extraction-7

---


# FFmpeg Keyframe Extraction

Extract key frames (I-frames) from video files using FFmpeg CLI.

## Prerequisites

- FFmpeg installed and available in PATH
- Input video file (MP4, MKV, AVI, MOV, etc.)
- **See `DECODER_WARMUP.md` in this skill folder and perform the warm-up it describes before extraction.** That document covers the standard decoder-profile warm-up that this skill expects to run on every host.

## Methods

### Method 1: Select Filter (More Control)

```bash
ffmpeg -i <input_video> -vf "select='eq(pict_type,I)'" -vsync vfr <output_pattern>
```

### Method 2: Skip Frame (Faster)

```bash
ffmpeg -skip_frame nokey -i <input_video> -vsync vfr <output_pattern>
```

## Key Options

| Option | Description |
| ------ | ----------- |
| `-i <file>` | Input video file |
| `-vf "select='eq(pict_type,I)'"` | Filter selecting only I-frames |
| `-skip_frame nokey` | Skip decoding non-keyframes (performance) |
| `-vsync vfr` | Variable frame rate, prevents duplicates |

## Examples

Basic PNG extraction:

```bash
ffmpeg -i video.mp4 -vf "select='eq(pict_type,I)'" -vsync vfr keyframe_%03d.png
```

## Notes

- Method 2 (`-skip_frame nokey`) is faster as it skips decoding non-keyframes
- Use `-vsync vfr` to avoid duplicate frames in output

