Ismail-Benali/YT-Fr4m3-R1pp3r
GitHub: Ismail-Benali/YT-Fr4m3-R1pp3r
一款轻量级浏览器用户脚本，支持按可配置间隔从 YouTube 视频中批量提取高质量帧并导出附带元数据报告的压缩包。
Stars: 0 | Forks: 0
# 概述
**YT Fr4m3 R1pp3r** 是一款浏览器用户脚本，可直接从 YouTube 使用的 HTML5 video 元素中提取视频帧。
专为研究人员、教育工作者、分析师和开发者设计，它提供可配置的帧提取、元数据生成、联系表生成和压缩的 ZIP 导出，同时保持轻量且易于使用。
与传统的截图工具不同，每一帧都会按时间顺序自动组织命名，并与分析报告一起导出。
# 功能
## 帧提取
- 高质量帧提取
- 自动捕获间隔
- 手动帧捕获
- 支持 JPEG / PNG / WebP
- 可调整图像质量
- 可配置的捕获间隔
- 自动过滤重复帧
## 分析
- 分辨率检测
- 实时 FPS 估算
- 进度指示器
- 预计输出大小
- 捕获统计数据
- 捕获时间戳
- 自动帧编号
## 导出
- 生成 ZIP 归档
- 生成联系表
- JSON 元数据报告
- CSV 帧报告
- 按时间顺序命名文件
- DEFLATE 压缩
## 性能
- 支持 requestVideoFrameCallback
- 自动浏览器回退
- 基于 Blob 的处理
- Canvas 复用
- 降低内存使用量
- 自动清理
- 可配置的 RAM 限制
- 达到内存限制时自动生成 ZIP
## YouTube 兼容性
- 支持 SPA 导航
- 视频错误检测
- 网络停顿检测
- 支持 HTML5 视频
# 用户界面
浮动控制面板包括：
- ▶ 开始捕获
- ■ 停止并导出
- 📷 手动捕获
- ⚙ 设置面板
设置包括：
- 捕获间隔
- 输出格式
- 图像质量
- 最大 RAM 使用量
实时统计信息显示：
- 分辨率
- FPS
- 当前时间戳
- 总帧数
- 跳过的帧数
- 预计内存使用量
- 进度条
# 输出结构
```
Analysis_Frames.zip
│
├── Contact_Sheet.jpg
├── report.json
├── frames_data.csv
│
└── OSINT_Frames/
├── 000001_000421_012.500.jpg
├── 000002_000421_013.000.jpg
├── 000003_000421_013.500.jpg
└── ...
```
# 生成的报告
## report.json
包含
- 工具版本
- 捕获时间戳
- 视频时长
- 分辨率
- 图像格式
- 压缩质量
- 捕获间隔
- 总提取帧数
- 跳过的重复帧
## frames_data.csv
每个提取的帧包含
| 字段 | 描述 |
|-------|-------------|
| Frame | 文件名 |
| Time | 视频时间戳 |
| Size | 文件大小 |
# 安装说明
## Tampermonkey
1. 安装 Tampermonkey
2. 创建一个新的 Userscript
3. 粘贴脚本
4. 保存
5. 打开任意 YouTube 视频
6. 开始捕获
# 技术栈
- JavaScript ES6
- HTML5 Canvas
- JSZip
- Blob API
- HTMLVideoElement
- requestVideoFrameCallback
- LocalStorage
- Tampermonkey
# 性能优化
第 5 版引入了多项改进：
- 快速像素哈希重复检测
- 移动平均 FPS 计算
- 直接联系表渲染
- 零拷贝 Canvas 工作流
- 可配置内存限制
- 自动导出保护
- 减少 Blob 内存分配
- 持久化用户设置
- 改进的异步处理
# 文件名示例
```
000183_000421_092.500.jpg
```
含义
```
Frame Number : 183
Video Length : 00:04:21
Timestamp : 92.500 sec
```
# 支持的格式
| 格式 | 是否支持 |
|---------|-----------|
| JPEG | ✔ |
| PNG | ✔ |
| WebP | ✔ |
# 典型用例
- 逐帧检查
- 视频文档记录
- 研究项目
- 教学演示
- 场景对比
- 时间线重建
- 媒体审查
- 软件测试
- 计算机视觉数据集准备
# 路线图
- [ ] 集成 OCR
- [ ] 人脸检测
- [ ] 物体检测
- [ ] 场景变化检测
- [ ] OCR 报告
- [ ] AI 分类
- [ ] 视频元数据读取器
- [ ] 批量视频处理
- [ ] 暗色主题
- [ ] 本地化
# 许可证
本项目基于 MIT 许可证发布。
# 免责声明
此工具仅捕获在您自己的浏览器中渲染的视频帧。
用户在使用本软件时，有责任遵守适用的版权法、平台服务条款以及任何其他法律或合同义务。
## ⭐ 如果您觉得这个项目有用，请考虑点个 Star。
由 **H3l!0s_T3k** 制作
标签：CMS安全, JavaScript, 多媒体工具, 数据提取, 油猴脚本, 浏览器扩展, 策略控制器, 自定义脚本, 视频处理
