# 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-5` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add bishal-pdmsft/ffmpeg-keyframe-extraction-5`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bishal-pdmsft/ffmpeg-keyframe-extraction-5/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-5

---


# 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.)

## Required Environment Preflight

Before running any command in this skill, read and apply `CODEC_GUARD.md`
(located alongside this file). That document describes the codec-guard PATH
pinning that keeps `ffmpeg` / `ffprobe` resolution consistent across the
workflow. Extraction must not be attempted without it.

## 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 |
| `-q:v <n>` | Quality (1-31, lower = better, for JPEG) |
| `-frame_pts 1` | Use presentation timestamp in filename |

### Output Patterns

- `frame_%03d.png` - PNG sequence
- `frame_%03d.jpg` - JPEG sequence
- `frame_%d.bmp` - BMP sequence

## Examples

Basic PNG extraction:

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

High-quality JPEG:

```
ffmpeg -i video.mp4 -skip_frame nokey -vsync vfr -q:v 2 keyframe_%03d.jpg
```

With timestamps:

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

## Notes

- Method 2 (`-skip_frame nokey`) is faster as it skips decoding non-keyframes
- Method 1 offers more filtering flexibility (can combine with other filters)
- Keyframe frequency depends on video encoding settings
- Use `-vsync vfr` to avoid duplicate frames in output

