AutoVideoMerge

KO | EN

gitlite — search

#react #ai #go #rust #nodejs #java #windows #kubernetes #vue #awesome-list #security #pytorch #mcp #open-source

(★ 11)

集成片头片尾检测、智能视频合并的一站式解决方案，从而动漫、短剧和电视剧等连续视频提供自动化批量处理。

AutoVideoMerge Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🎬 AutoVideoMerge
<p align="center">
  <img src="./cover_1200x630.png" alt="AutoVideoMerge 封面" width="1000"/>
</p>

> 集成片头片尾检测、智能视频合并的一站式脚本解决方案
> 为动漫、短剧、电视剧和教学视频等连续视频提供自动化批量处理

![GitHub](https://img.shields.io/badge/Python-3.7+-blue.svg) ![FFmpeg](https://img.shields.io/badge/FFmpeg-Required-red.svg) ![License](https://img.shields.io/badge/License-MIT-green.svg)

## 1. 📖 背景说明
在日常观看动漫、短剧、电视剧或学习视频进行二刷乃至于多刷时，反复出现的片头和片尾往往会打断沉浸感，影响连续观看体验。
基于这一痛点，本项目应运而生 —— 通过自动化脚本实现 **片头片尾检测与智能合并**，有效去除冗余内容，仅保留关键的剧情与知识点。

处理完成的视频不仅更适合在 **家庭影院** 或个人观影环境中播放，还能在学习复盘、整理资料时提供更高效、专注的体验。

> 注意：该项目以现在最火的动漫《凡人修仙传》为例进行操作，要剪辑的视频源文件请合法合规自行准备。

## 2. 🌟 核心功能
| 功能 | 描述 | 特色 |
|------|------|------|
| 🔍 **片头片尾检测** | 智能识别视频开头结尾位置 | 基于参考时间±5秒精准定位 |
| 🔗 **智能视频合并** | 自动裁剪并拼接视频 | 保留首集片头、末集片尾 |
| 🚀 **一键处理** | 检测+合并完整流程 | 交互式确认，可控流程 |
| ⚡ **快速处理** | 全自动无确认模式 | 输入目录即可，零干预 |
| ⚙️ **配置管理** | 持久化用户设置 | 记住常用路径和参数 |

## 3. 🎯 使用场景
- **动漫合集制作**：自动去除片头片尾，制作无缝观看体验；
- **短剧**：自动快速处理短剧集，生成连续观看合集；
- **电视剧整理**：批量处理连续剧集，生成完整合集；
- **教学视频**：去除重复的开场和结尾，专注内容；
- **会议录像**：移除固定的会议开场和结束部分。

## 4. ⚡ 快速开始
### 4.1 📦 安装依赖
```bash
# 安装Python依赖
pip install opencv-python numpy tqdm

# 安装FFmpeg (macOS)
brew install ffmpeg

# 安装FFmpeg (Windows)
# 下载并配置环境变量：https://ffmpeg.org/download.html
```

### 4.2 🚀 运行程序
```bash
# 推荐方式：使用启动器
python3 run.py

# 直接启动主程序
python3 video_processor.py

# 命令行批处理模式
python3 video_processor.py --batch --input ./videos
```

## 5. 📋 功能菜单
启动后您将看到以下菜单：
```
========================================
📋 主菜单
========================================
1. 🔍 检测片头片尾
2. 🔗 合并视频  
3. 🚀 一键处理 (检测+合并)
4. ⚡ 快速一键处理 (全自动)
5. ⚙️ 配置设置
6. 📊 查看历史记录
7. 🛠️ 工具和实用功能
8. ❓ 帮助
0. 👋 退出
========================================
```

### 5.1 🎮 推荐使用流程
#### 5.1.1 初次使用（推荐选项3）
1. 选择 `3. 🚀 一键处理`
2. 输入视频目录：`8.重返天南[连载中]`
3. 确认输出文件名：`8.重返天南[连载中]/merged.mp4`
4. 等待自动完成

#### 5.1.2 熟练用户（推荐选项4）
1. 选择 `4. ⚡ 快速一键处理`
2. 输入视频目录：`8.重返天南[连载中]`
3. 全自动执行，生成：`8.重返天南[连载中]/8.重返天南[连载中]_合集.mp4`

## 6. 🔧 高级功能
### 6.1 📂 智能路径处理
- **目录输入**：直接输入 `8.重返天南[连载中]`，自动查找 `detection_results.json`
- **特殊字符支持**：正确处理包含 `[共4集]` 等字符的目录名
- **相对路径**：支持 `./videos`、`../projects` 等相对路径

### 6.2 🎛️ 配置选项
| 配置项 | 默认值 | 说明 |
|--------|--------|------|
| 默认输入目录 | `.` | 视频文件夹路径 |
| 默认输出文件 | `merged.mp4` | 合并后的文件名 |
| 搜索范围 | `5秒` | 参考时间搜索精度 |
| 强制重编码 | `否` | 是否跳过零转码优化 |
| 保留首集片头 | `是` | 是否保留第一个视频的片头 |
| 保留末集片尾 | `是` | 是否保留最后一个视频的片尾 |

### 6.3 📊 参考时间格式
创建 `reference_times.json` 文件来提供精确的时间参考：
```json
[
  {
    "file": "./《凡人修仙传之重返天南》第1集.mp4",
    "reference_end": "2:46",    // 片头结束时间
    "reference_start": "18:57"   // 片尾开始时间
  },
  {
    "file": "./《凡人修仙传之重返天南》第2集.mp4", 
    "reference_end": "2:43",
    "reference_start": "18:36"
  }
]
```

## 7. 📁 文件结构说明
```
AutoVideoMerge/                         # 工具根目录
├── run.py                          # 🚀 启动器（环境检查）
├── video_processor.py              # 🎛️ 主控程序（交互界面）
├── reference_detector.py           # 🔍 检测模块（算法核心）
├── merge_video.py                  # 🔗 合并模块（FFmpeg封装）
├── start.sh                        # 🐚 Shell启动脚本
├── README.md                       # 📖 说明文档
├── video_processor_config.json     # ⚙️ 配置文件（自动生成）
└── 项目目录/                        # 📂 视频项目文件夹
    ├── reference_times.json        # ⏰ 参考时间配置
    ├── detection_results.json      # 📊 检测结果（自动生成）
    ├── merged.mp4                  # 🎬 合并结果（自动生成）
    └── *.mp4                       # 📹 原始视频文件
```

## 8. 🎥 实际案例
### 8.1 案例1：动漫合集制作
```bash
# 目录结构
8.重返天南[连载中]/
├── 《凡人修仙传之重返天南》第1集.mp4
├── 《凡人修仙传之重返天南》第2集.mp4
├── 《凡人修仙传之重返天南》第3集.mp4
├── 《凡人修仙传之重返天南》第4集.mp4
└── reference_times.json

# 处理结果
8.重返天南[连载中]/
├── [原始文件...]
├── detection_results.json          # 检测结果
└── 8.重返天南[连载中]_合集.mp4            # 最终合集（快速模式）
```

### 8.2 案例2：批量处理多个项目
```bash
# 项目结构
AutoVideoMerge/
├── 1.凡人修仙传之风气天南[共17集]/
├── 2.凡人修仙传之燕家堡之战[共4集]/
├── 3.魔道争锋[共25集]/
├── 4.再别天南[共14集/
├── 5.初入星海[共12集]/
├── 6.星海飞驰[共52集]/
├── 7.海外风云[共28集]/
├── 8.重返天南[连载中]/
└── [工具文件...]

# 逐个处理每个项目
# 选择4，输入 1.凡人修仙传之风气天南[共17集]
# 选择4，输入 2.凡人修仙传之燕家堡之战[共4集]
# 选择4，输入 8.重返天南[连载中]
```

## 9. 🔧 技术原理
### 9.1 检测算法
1. **参考时间加载** - 读取 `reference_times.json` 配置
2. **黑屏检测** - 使用FFmpeg的blackdetect滤镜
3. **智能匹配** - 在参考时间±5秒范围内查找最佳匹配点
4. **结果验证** - 确保片头结束时间 < 片尾开始时间

### 9.2 合并策略
1. **零转码优先** - 使用 `ffmpeg -c copy` 快速裁剪
2. **自动回退** - 失败时切换到重编码模式
3. **质量保证** - 重编码使用 `libx264 -crf 18` 高质量设置
4. **格式统一** - 确保所有片段编码参数一致

## 10. ❗ 常见问题
### 10.1 提示 **"FFmpeg 未找到"** 怎么办？
请确保 **FFmpeg** 已正确安装：
- **macOS**: `brew install ffmpeg`
- **Windows**: 下载便携版，解压后将 **bin** 目录添加到 **PATH 环境变量**
- **Linux**: `sudo apt install ffmpeg` 或 `sudo yum install ffmpeg`
- **验证**: 运行 `ffmpeg -version` 确认安装成功

### 10.2 检测结果不准确，片头片尾时间偏差较大？
可以通过以下方式改进：
1. **调整搜索范围**：配置设置 → 搜索范围(秒) → 改为 **10** 或 **15**
2. **提供参考时间**：创建 `reference_times.json` 文件，手动指定准确时间
3. **检查视频质量**：确保视频文件完整，无损坏

### 10.3 合并时提示 **"零转码失败"**？
这是正常现象，程序会自动回退：
1. **自动处理**：自动切换到 **重编码模式**，稍等即可
2. **手动强制**：配置设置 → 强制重编码 → 选择 **是**
3. **原因说明**：不同视频的编码参数差异导致无法直接合并

### 10.4 目录名包含特殊字符（如方括号）无法识别？
**v2.5版本** 已修复此问题，以下示例均支持：
- ✅ `2.凡人修仙传之燕家堡之战[共4集]`
- ✅ `视频 (1080p)`
- ✅ `Season-1 [BD]`

### 10.5 没有进度条显示？
安装 **tqdm** 获得更好体验：
```bash
pip install tqdm
```

## 11. 🔄 更新日志
### 11.1 v2.0 (最新)
- ✨ 新增快速一键处理模式（选项4）
- 🐛 修复特殊字符目录名识别问题
- 🎯 改进路径智能处理逻辑
- 📊 增强文件大小显示

### 11.2 v1.1
- 🎨 全新交互式菜单界面
- 📊 实时进度条和状态显示
- ⚙️ 配置管理和持久化
- 📝 操作历史记录

### 11.3 v1.0
- 🔍 基础片头片尾检测功能
- 🔗 视频合并和裁剪
- 💻 命令行界面

## 12. 📈 性能指标
| 指标 | 性能 | 说明 |
|------|------|------|
| 检测速度 | ~30秒/集 | 20分钟视频，±5秒搜索范围 |
| 合并速度 | ~5分钟/GB | 零转码模式，取决于磁盘I/O |
| 内存占用 | <500MB | 处理4K视频时的峰值 |
| 支持格式 | MP4/AVI/MKV/MOV/WMV | 主流视频格式 |

## 13. 🤝 贡献指南
欢迎提交 Issue 和 Pull Request！
- 🐛 **Bug 报告**: 请提供详细的错误信息和复现步骤
- 💡 **功能建议**: 描述具体的使用场景和预期效果
- 📝 **文档改进**: 帮助完善使用说明和案例

## 14. 📄 其它说明
本项目仅用于学习与技术交流，严禁用于任何商业用途。  
请大家自觉遵守相关版权法规与法律要求，确保视频资源的获取和使用合法合规。

AutoVideoMerge

AutoVideoMerge Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

AutoVideoMerge

AutoVideoMerge Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README