AB-Video-Deduplicator

AB Video Processor

简体中文 | English

用于视频帧混合、格式转换与视觉特征实验的桌面工具。

项目通过对两段视频进行抽帧、混合与重新编码，研究不同帧率、编码参数和 GPU 加速方案对输出视频视觉表现及数据特征的影响。仓库名 AB-Video-Deduplicator 为项目早期命名，现以 AB Video Processor 名义维护。

请仅处理拥有合法使用权的素材。本项目为早期实验版本，仅供技术研究与学习交流，不用于绕过平台审核、版权识别或其他安全机制。

项目背景

在视频处理和内容生产流程中，经常需要验证不同帧率、分辨率、混合策略和编码方式对输出结果的影响。手工执行 FFmpeg 命令不利于非技术用户重复调整和比较参数。

本项目将相关处理流程封装为图形化工具，提供可重复的参数配置与进度反馈，让同一组实验可以在不同素材上快速复现。

主要能力

• 读取两段视频并分析基础媒体信息（分辨率、帧率、时长、编码格式）
• 按配置进行抽帧与帧混合，提供 50%（60fps）、75%（120fps）、87.5%（240fps）三档处理强度
• 自动将素材视频的分辨率对齐到内容视频，统一帧率与编码参数
• 完整保留内容视频的原始音轨
• 在兼容环境下启用 NVIDIA NVENC 硬件编码加速，大幅提升处理速度
• 基于 PyQt5 的图形界面，无需命令行知识，实时展示处理进度与详细日志
• 跨平台运行（Windows / macOS / Linux，需正确安装依赖）

📸 软件截图

技术流程

Video A + Video B
    -> Media inspection
    -> Resolution alignment
    -> Frame sampling and mixing
    -> FFmpeg encoding
    -> Output validation

帧混合原理

工具的底层策略是"高帧率抽帧混合"，而非滤镜、缩放这类表层处理：

1. 输入两段视频：内容视频 A 与一段独立的素材视频 B。
2. 构造高帧率输出流：创建一个 60 / 120 / 240 fps 的目标视频流。
3. 按算法插入帧：将视频 A 的帧逐一插入输出流的关键位置，相邻 A 帧之间用视频 B 的帧填充。
4. 重新编码输出：播放器按高帧率解码时，人眼感知的仍是视频 A 的连续画面；而从文件数据层面看，输出包含大量来自视频 B 的帧，其 MD5 与数据特征与源文件完全不同。

各档强度对应的帧构成如下：

处理强度	目标 FPS	A:B 帧大致比例
50%	60	1 : 1
75%	120	1 : 3
87.5%	240	1 : 7

主要技术：Python、PyQt5、NumPy、OpenCV、FFmpeg。

快速开始

环境要求

• Python 3.8+
• FFmpeg（需加入 PATH；Windows 可从 gyan.dev 下载，macOS 用 brew install ffmpeg，Linux 用 sudo apt install ffmpeg）

git clone https://github.com/toki-plus/AB-Video-Deduplicator.git
cd AB-Video-Deduplicator
python -m venv venv

激活虚拟环境后安装依赖并启动：

pip install -r requirements.txt
pyrcc5 src/resources.qrc -o src/resources.py   # 编译 Qt 图标资源
python src/main.py

使用说明

1. 选择两段拥有合法使用权的视频素材（内容视频 A 与素材视频 B）。
2. 选择处理强度（建议从 60fps 档开始测试）和输出目录。
3. 如本机具备兼容的 NVIDIA 环境，可启用 GPU 加速。
4. 启动任务，处理结果保存在 output 目录，检查输出视频的画面、音频和时长。

当前限制

• 输出效果受源视频分辨率、帧率和编码格式影响。
• GPU 加速依赖本机 FFmpeg 构建与驱动环境。
• 当前仅包含基础测试工具，尚未建立完整的自动化回归测试。

📂 更多项目

• video-mover — 多平台内容分发自动化流水线：素材处理、文案生成、定时调度与多平台适配
• ai-highlight-clip — 长视频智能初筛：Whisper 转写 + LLM 评分 + 人工终审，分钟级定位高光片段
• ai-ttv-workflow — 文案到短视频的桌面工作流，关键节点保留人工确认
• ai-video-workflow — 多模型 AIGC 视频生成流水线：文生图、图生视频、文生音乐的异步编排
• ai-mixed-cut — 素材库结构化与脚本重组的视频再创作工作流
• ai-trader-for-mt4 — LLM×MT4 受控执行框架：工具约束、风控规则、状态管理与异步桥接
• ai-trader-for-mt5 — 面向 MT5 的 AI 交易助手与 EA 工程化框架
• auto-usps-tracker — 跨境电商批量物流追踪与 Excel 报告自动化
• netease-downloader — 网易云音乐下载桌面应用：扫码登录、下载队列、ID3 元数据写入

License

See LICENSE.