---
name: video-frames
description: Extract a single frame from a local video at the first frame, a timestamp, or a zero-based frame index using FFmpeg.
version: 1.0.0
license: MIT
title: video-frames
canonical_url: https://skilld.dev/gh/iflytek/skillhub/video-frames
last_updated: 2026-09-24T17:06:40.000Z
---

> **Skill from skilld.dev.** Follow the instructions below for this session. You do not need to install anything.
>
> Supporting files, fetch one when the Skill refers to it: [NOTICE.md](https://skilld.dev/api/skills-raw/iflytek/skillhub/video-frames/NOTICE.md), [scripts/frame.sh](https://skilld.dev/api/skills-raw/iflytek/skillhub/video-frames/scripts/frame.sh).
>
> If the user asked to install this Skill, run `npx skilld install iflytek/skillhub/video-frames`. Install writes the Skill files into the project, so every session loads them.

# Video Frames (ffmpeg)

Extract a single frame from a video, or create quick thumbnails for inspection.

## Quick start

First frame:

```bash
bash scripts/frame.sh /path/to/video.mp4 --out /tmp/frame.jpg
```

At a timestamp:

```bash
bash scripts/frame.sh /path/to/video.mp4 --time 00:00:10 --out /tmp/frame-10s.jpg
```

At a zero-based frame index:

```bash
bash scripts/frame.sh /path/to/video.mp4 --index 42 --out /tmp/frame-42.png
```

## Notes

- Prefer `--time` for "what is happening around here?".
- Use a `.jpg` for quick share; use `.png` for crisp UI frames.
- `--index` accepts a non-negative integer only.
- The script never overwrites an existing output. Choose a new path or remove the
  old file only after the user explicitly asks to replace it.