视频比较器
- 作者仓库星标 0
- 作者更新于 2026年8月24日 07:33
- 作者仓库 claude-code-skills
- 领域
- 通用
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @daymade · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- macOS · Linux · Windows
- 运行环境要求
- Python >=3.8
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 命令执行
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# 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
```bash
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
```bash
# 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):
```bash
# 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 章节与文件索引
按说明文件中的顺序排列。
概述
何时使用此技能
基本命令
系统依赖
视频规格
文件/命令 -> comparison.html · .mp4 · .mov · .avi · .mkv · .webm · references/video_metrics.md · shell=True
内容校验值 -> 6a3a3a87ff19
当前原文的自动摘译,尚未人工审校。
概述
比较两个视频并生成分析压缩结果的交互式 HTML 报告。该脚本提取视频元数据,计算质量指标(PSNR、SSIM),并使用三种查看模式(滑块、并排和网格)创建逐帧视觉比较。
何时使用此技能
在以下情况下使用此技能: 比较原始视频和压缩视频 分析视频压缩质量和效率 评估编解码器性能或比特率降低影响 用户提及“比较视频”、“视频质量”、“压缩分析”或“压缩之前/之后”
基本命令
生成
comparison.html,其中: 视频参数(编解码器、分辨率、比特率、持续时间、文件大小) 质量指标(PSNR、SSIM、大小/比特率降低百分比) 逐帧比较(默认:帧间隔为 5 秒)系统依赖
FFmpeg 和 FFprobe(视频分析和帧提取所需):Python 3.8+(使用类型提示、f 字符串、pathlib)
视频规格
支持的格式:
.mp4(推荐)、.mov、.avi、.mkv、.webm文件大小限制:每个视频 500MB(可配置) 处理时间:典型视频约 1-2 分钟;随持续时间和帧间隔而变化