视频比较器 - 专业视频压缩质量分析工具，支持PSNR/SSIM指标和交互式报告

video-comparer by daymade/claude-code-skills

157 周安装量

775 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/daymade/claude-code-skills --skill video-comparer

自动化数据分析音频处理

🇨🇳中文介绍

视频比较器

概述

比较两个视频并生成交互式 HTML 报告，分析压缩结果。该脚本提取视频元数据，计算质量指标（PSNR、SSIM），并创建三种查看模式的逐帧视觉比较：滑块模式、并排模式和网格模式。

何时使用此技能

在以下情况下使用此技能：

比较原始视频和压缩视频
分析视频压缩质量和效率
评估编解码器性能或码率降低的影响
用户提及"比较视频"、"视频质量"、"压缩分析"或"压缩前后"

核心用法

基本命令

python3 scripts/compare.py original.mp4 compressed.mp4

生成包含以下内容的 comparison.html：

视频参数（编解码器、分辨率、码率、时长、文件大小）
质量指标（PSNR、SSIM、大小/码率降低百分比）
逐帧比较（默认：每 5 秒间隔的帧）

命令选项

# 自定义输出文件
python3 scripts/compare.py original.mp4 compressed.mp4 -o report.html

# 自定义帧间隔（数值越大，帧数越少，处理越快）
python3 scripts/compare.py original.mp4 compressed.mp4 --interval 10

# 批量比较
for original in originals/*.mp4; do
    compressed="compressed/$(basename "$original")"
    output="reports/$(basename "$original" .mp4).html"
    python3 scripts/compare.py "$original" "$compressed" -o "$output"
done

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

Azure Data Explorer (Kusto) 查询技能：KQL数据分析、日志遥测与时间序列处理

133,300 周安装

Azure RBAC 权限管理工具：查找最小角色、创建自定义角色与自动化分配

131,500 周安装

专业SEO审计工具：全面网站诊断、技术SEO优化与页面分析指南

66,700 周安装

FFmpeg 和 FFprobe（视频分析和帧提取所需）：

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt update && sudo apt install ffmpeg

# Windows
# 从 https://ffmpeg.org/download.html 下载
# 或使用：winget install ffmpeg

Python 3.8+（使用类型提示、f-字符串、pathlib）

支持的格式： .mp4（推荐）、.mov、.avi、.mkv、.webm
文件大小限制： 每个视频 500MB（可配置）
处理时间： 典型视频约 1-2 分钟；根据时长和帧间隔而异

脚本自动验证：

FFmpeg/FFprobe 的安装和可用性
文件存在性、扩展名和大小限制
路径安全性（防止目录遍历）

验证失败时，会显示带有解决指导的清晰错误信息。

脚本计算两个标准质量指标：

PSNR（峰值信噪比）： 像素级相似度测量（20-50 dB 范围，越高越好）

SSIM（结构相似性指数）： 感知相似度测量（0.0-1.0 范围，越高越好）

有关详细的解释范围和质量阈值，请查阅 references/video_metrics.md。

脚本在指定间隔（默认：5 秒）提取帧，将它们缩放到一致的高度（800px）以便比较，并将其作为 base64 数据 URL 嵌入到自包含的 HTML 中。临时文件在处理后会自动清理。

生成的 HTML 报告包括：

滑块模式：拖动以显示原始视频与压缩视频（默认）
并排模式：同时显示以进行直接比较
网格模式：紧凑的两列布局
缩放控制：50%-200% 放大倍数
自包含格式（无需服务器，可离线工作）

路径验证（绝对路径，防止目录遍历）
命令注入预防（不使用 shell=True，验证参数）
资源限制（文件大小、超时）
自定义异常：ValidationError、FFmpegError、VideoComparisonError

"未找到 FFmpeg"：通过平台包管理器安装 FFmpeg（参见要求部分）

"文件过大"：在比较前压缩视频，或调整 scripts/compare.py 中的 MAX_FILE_SIZE_MB

"操作超时"：增加 FFMPEG_TIMEOUT 常量或使用更大的 --interval 值（处理更少的帧）

"帧数不匹配"：视频具有不同的时长/帧率；脚本会自动截断到最小帧数并显示警告

脚本包含可调整的常量，用于文件大小限制、超时、帧尺寸和提取间隔。要自定义行为，请编辑 scripts/compare.py 顶部的常量。有关详细的配置选项及其影响，请查阅 references/configuration.md。

查阅以下文件以获取详细信息：

references/video_metrics.md：质量指标解释（PSNR/SSIM 范围、压缩目标、码率指南）
references/ffmpeg_commands.md：FFmpeg 命令参考（元数据提取、帧提取、故障排除）
references/configuration.md：脚本配置选项和可调整常量
assets/template.html：用于自定义查看模式和样式的 HTML 报告模板

🇺🇸English

Video Comparer

Overview

Compare two videos and generate an interactive HTML report analyzing compression results. The script extracts video metadata, calculates quality metrics (PSNR, SSIM), and creates frame-by-frame visual comparisons with three viewing modes: slider, side-by-side, and grid.

When to Use This Skill

Use this skill when:

Comparing original and compressed videos
Analyzing video compression quality and efficiency
Evaluating codec performance or bitrate reduction impact
Users mention "compare videos", "video quality", "compression analysis", or "before/after compression"

Core Usage

Basic Command

python3 scripts/compare.py original.mp4 compressed.mp4

Generates comparison.html with:

Video parameters (codec, resolution, bitrate, duration, file size)
Quality metrics (PSNR, SSIM, size/bitrate reduction percentages)
Frame-by-frame comparison (default: frames at 5s intervals)

Command Options

# Custom output file
python3 scripts/compare.py original.mp4 compressed.mp4 -o report.html

# Custom frame interval (larger = fewer frames, faster processing)
python3 scripts/compare.py original.mp4 compressed.mp4 --interval 10

# Batch comparison
for original in originals/*.mp4; do
    compressed="compressed/$(basename "$original")"
    output="reports/$(basename "$original" .mp4).html"
    python3 scripts/compare.py "$original" "$compressed" -o "$output"
done

Requirements

System Dependencies

FFmpeg and FFprobe (required for video analysis and frame extraction):

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt update && sudo apt install ffmpeg

# Windows
# Download from https://ffmpeg.org/download.html
# Or use: winget install ffmpeg

Python 3.8+ (uses type hints, f-strings, pathlib)

Video Specifications

Supported formats: .mp4 (recommended), .mov, .avi, .mkv, .webm
File size limit: 500MB per video (configurable)
Processing time: ~1-2 minutes for typical videos; varies by duration and frame interval

Script Behavior

Automatic Validation

The script automatically validates:

FFmpeg/FFprobe installation and availability
File existence, extensions, and size limits
Path security (prevents directory traversal)

Clear error messages with resolution guidance appear when validation fails.

Quality Metrics

The script calculates two standard quality metrics:

PSNR (Peak Signal-to-Noise Ratio): Pixel-level similarity measurement (20-50 dB scale, higher is better)

SSIM (Structural Similarity Index): Perceptual similarity measurement (0.0-1.0 scale, higher is better)

For detailed interpretation scales and quality thresholds, consult references/video_metrics.md.

Frame Extraction

The script extracts frames at specified intervals (default: 5 seconds), scales them to consistent height (800px) for comparison, and embeds them as base64 data URLs in self-contained HTML. Temporary files are automatically cleaned after processing.

Output Report

The generated HTML report includes:

Slider Mode : Drag to reveal original vs compressed (default)
Side-by-Side Mode : Simultaneous display for direct comparison
Grid Mode : Compact 2-column layout
Zoom Controls : 50%-200% magnification
Self-contained format (no server required, works offline)

Important Implementation Details

Security

The script implements:

Path validation (absolute paths, prevents directory traversal)
Command injection prevention (no shell=True, validated arguments)
Resource limits (file size, timeouts)
Custom exceptions: ValidationError, FFmpegError, VideoComparisonError

Common Error Scenarios

"FFmpeg not found" : Install FFmpeg via platform package manager (see Requirements section)

"File too large" : Compress videos before comparison, or adjust MAX_FILE_SIZE_MB in scripts/compare.py

"Operation timed out" : Increase FFMPEG_TIMEOUT constant or use larger --interval value (processes fewer frames)

"Frame count mismatch" : Videos have different durations/frame rates; script auto-truncates to minimum frame count and shows warning

Configuration

The script includes adjustable constants for file size limits, timeouts, frame dimensions, and extraction intervals. To customize behavior, edit the constants at the top of scripts/compare.py. For detailed configuration options and their impacts, consult references/configuration.md.

Reference Materials

Consult these files for detailed information:

references/video_metrics.md : Quality metrics interpretation (PSNR/SSIM scales, compression targets, bitrate guidelines)
references/ffmpeg_commands.md : FFmpeg command reference (metadata extraction, frame extraction, troubleshooting)
references/configuration.md : Script configuration options and adjustable constants
assets/template.html : HTML report template for customizing viewing modes and styling

Weekly Installs

123

Repository

daymade/claude-…e-skills

GitHub Stars

708

First Seen

Jan 21, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

claude-code108

opencode100

gemini-cli95

codex95

cursor89

github-copilot87

Python PDF处理教程：合并拆分、提取文本表格、创建PDF文件

62,800 周安装