HomeBrowseUpload
← Back to registry
// Skill profile

Video Frame Capture

name: video-frame-capture

by chentx1243 · published 2026-03-22

图像生成
Total installs
0
Stars
★ 0
Last updated
2026-03
// Install command
$ claw add gh:chentx1243/chentx1243-maple-video-capture
View on GitHub
// Full documentation

---

name: video-frame-capture

description: Capture key frames from video files at fixed time intervals. Use when you need to understand video content by extracting screenshots, or when you need to analyze video frames for content recognition. Supports skipping similar frames to avoid redundant captures.

---

# Video Frame Capture

Overview

This skill enables capturing key frames from video files at fixed time intervals. It's designed to help you understand video content by extracting screenshots for analysis or content recognition.

When to Use This Skill

Use this skill when:

  • You need to understand video content by extracting key frames
  • You want to analyze video frames for content recognition
  • You need to create a visual summary of a video
  • You want to skip similar frames to avoid redundant captures
  • Quick Start

    Capture frames from a video at 10-second intervals:

    python scripts/video_frame_capture.py --input "D:\videos\meeting.mp4" --output-dir "D:\frames\meeting" --interval-seconds 10
    

    Parameters

  • `--input`: Path to the local video file (required)
  • `--output-dir`: Directory where captured frames will be stored (required)
  • `--interval-seconds`: Capture interval in seconds, must be greater than 0 (required)
  • `--skip-similar-frames`: Skip frames that are similar to the previous saved frame
  • `--similarity-threshold`: Similarity threshold in range 0-1, defaults to 0.70
  • `--image-extension`: Image format for saved frames, defaults to jpg
  • Output Naming

    Output files follow the format: `视频文件原始名称_视频时间轴_第几次截取.jpg`

    Example: `meeting_00h01m30s_0003.jpg`

    Similar Frame Skipping

    When `--skip-similar-frames` is enabled, the script compares the current candidate frame with the previous saved frame:

  • Similarity > threshold: Frame is skipped
  • Similarity ≤ threshold: Frame is saved and becomes the new comparison baseline
  • Examples

    Basic frame capture

    python scripts/video_frame_capture.py --input "D:\videos\meeting.mp4" --output-dir "D:\frames\meeting" --interval-seconds 10
    

    Skip similar frames

    python scripts/video_frame_capture.py --input "D:\videos\meeting.mp4" --output-dir "D:\frames\meeting" --interval-seconds 10 --skip-similar-frames
    

    Custom similarity threshold

    python scripts/video_frame_capture.py --input "D:\videos\meeting.mp4" --output-dir "D:\frames\meeting" --interval-seconds 10 --skip-similar-frames --similarity-threshold 0.80
    

    Resources

    scripts/

  • `video_frame_capture.py`: Main script for capturing video frames
  • references/

  • `video_formats.md`: Supported video formats and technical details
  • ---

    **Note:** This skill requires OpenCV (opencv-python-headless) to be installed. Install dependencies with: `pip install -r requirements.txt`

    // Comments
    Sign in with GitHub to leave a comment.
    // Related skills

    More tools from the same signal band