kekkooo86/video-splitter

🎬 视频分割工具

将长视频分割为带专业标签和自动标题的片段，完美适用于社交媒体、视频系列或任何需要拆分为短视频的内容。

https://img.shields.io/docker/v/kekkooo86/video-splitter?label=Docker%20Hub&logo=docker](https://hub.docker.com/r/kekkooo86/video-splitter) https://img.shields.io/badge/License-MIT-yellow.svg](LICENSE)

---

🚀 快速开始

使用Docker（推荐）

bash
# 拉取镜像
docker pull kekkooo86/video-splitter:latest

# 使用
docker run -v $(pwd):/videos kekkooo86/video-splitter -i video.mp4 -T "纪录片|意大利"

本地使用

bash
# 克隆仓库
git clone https://github.com/kekkooo86/video-splitter.git
cd video-splitter

# 使用
chmod +x split_video.sh
./split_video.sh -i video.mp4 -T "标题"

---

✨ 核心功能

• ✂️ 将视频分割为片段（默认60秒）
• 🏷️ 自动生成“Part X”标签
• 🎨 居中的淡入效果标题
• 📱 自动检测宽高比（9:16、16:9、1:1）
• ⏱️ 处理特定时间范围（开始/结束）
• 🖼️ 从任意边裁剪视频（移除黑边）
• ⚡ 并行处理（最多3个视频）
• 🧪 测试模式

---

📋 参数说明

bash
./split_video.sh -i 视频文件 [选项]

选项:
  -i FILE       待处理视频（必填）
  -s SECONDS    片段时长（默认：60，支持浮点数）
  -o SECONDS    重叠时长（默认：5，支持浮点数）
  -S SECONDS    开始时间（默认：0，支持浮点数）
  -E SECONDS    结束时间（默认：视频总时长，支持浮点数）
  -T "文本"     开头标题（用|换行）
  -l on/off     "Part X"标签开关（默认：on）
  -L "文本"     自定义标签文本（替换"Part X"）
  -p 1-3        并行数（默认：1）
  --crop-top N     从顶部裁剪N像素
  --crop-bottom N  从底部裁剪N像素
  --crop-left N    从左侧裁剪N像素
  --crop-right N   从右侧裁剪N像素
  --test-first  仅测试第一个片段

---

🎯 示例

基础用法

bash
./split_video.sh -i documentary.mp4

带标题

bash
./split_video.sh -i documentary.mp4 -T "南方|纪录片"

自定义标签替代"Part X"

bash
./split_video.sh -i video.mp4 -L "第1集" -T "电视剧"

精确时间（浮点数）

bash
# 每59.5秒分割，重叠2.5秒
./split_video.sh -i video.mp4 -s 59.5 -o 2.5

# 处理30.25秒到3分15.75秒的部分
./split_video.sh -i video.mp4 -S 30.25 -E 195.75

处理特定时间范围

bash
# 仅处理30秒到3分钟的部分
./split_video.sh -i video.mp4 -S 30 -E 180

# 从1分钟开始处理到结束
./split_video.sh -i video.mp4 -S 60

并行处理

bash
./split_video.sh -i video.mp4 -T "系列" -p 2

测试第一个片段

bash
./split_video.sh -i video.mp4 -T "测试" --test-first

裁剪视频（移除边框）

bash
# 移除顶部和底部黑边（letterbox）
./split_video.sh -i video.mp4 --crop-top 100 --crop-bottom 100

# 移除两侧黑边（pillarbox）
./split_video.sh -i video.mp4 --crop-left 200 --crop-right 200

# 仅裁剪，无标签无标题（快速重新编码）
./split_video.sh -i video.mp4 --crop-left 250 --crop-right 150 -l off

# 从四边裁剪
./split_video.sh -i video.mp4 --crop-top 50 --crop-bottom 50 --crop-left 100 --crop-right 100

# 裁剪+标题+自定义标签
./split_video.sh -i video.mp4 --crop-top 140 --crop-bottom 140 -T "纪录片" -L "第1集"

---

🐳 Docker使用

从Docker Hub拉取

bash
docker pull kekkooo86/video-splitter:latest

本地构建

bash
docker build -t video-splitter:1.4.2 .

使用你的视频

基础用法：

bash
# 将你的视频目录挂载到容器内的/videos
docker run --rm \
  -v /path/to/your/videos:/videos \
  kekkooo86/video-splitter \
  -i your-video.mp4

带自定义标签和标题：

bash
docker run --rm \
  -v /Users/kekko/Downloads:/videos \
  kekkooo86/video-splitter \
  -i video.mp4 \
  -L "第1集" \
  -T "电视剧"

带浮点数时间：

bash
docker run --rm \
  -v $(pwd):/videos \
  kekkooo86/video-splitter \
  -i video.mp4 \
  -s 59.5 \
  -o 2.5 \
  -L "自定义部分"

📂 输出位置

输出文件夹将在原始视频文件旁边的挂载目录中创建：

/path/to/your/videos/
├── your-video.mp4                    # 原始文件
└── your-video/                       # 自动创建的输出文件夹
    ├── your-video_parte_01.mp4
    ├── your-video_parte_02.mp4
    └── your-video_parte_03.mp4

示例：

bash
# 如果你的视频在/Users/kekko/Downloads/
docker run --rm -v /Users/kekko/Downloads:/videos kekkooo86/video-splitter -i myvideo.mp4

# 输出将在：
# /Users/kekko/Downloads/myvideo/myvideo_parte_01.mp4
# /Users/kekko/Downloads/myvideo/myvideo_parte_02.mp4
# 等等

---

🔧 依赖要求

• Docker（推荐）或：
• FFmpeg 4.4+
• Bash 4+
• bc（基础计算器）

---

📝 安装方法

macOS

bash
brew install ffmpeg

Linux（Ubuntu/Debian）

bash
sudo apt-get install ffmpeg bc

使用方法

bash
chmod +x split_video.sh
./split_video.sh -i video.mp4

---

❓ 常见问题

标题会出现在所有片段中吗？

是的！标题会在每个片段的前N秒（重叠时长，默认5秒）出现。因为每个片段的时间线从t=0开始。

重叠功能如何工作？

每个片段与前一个片段重叠。例如：

• 片段1：0s → 60s
• 片段2：55s → 115s（5秒重叠）
• 片段3：110s → 170s（5秒重叠）

标题出现在每个片段的重叠部分（前5秒），以保证连贯性。

可以不使用标题仅裁剪吗？

可以！从v1.4.1版本开始，即使没有-T或标签，裁剪参数也能正常工作。之前当没有标题或标签时裁剪会被静默忽略（视频直接复制不重新编码），现在任何裁剪选项都会自动触发重新编码：

bash
# 现在可以正确裁剪视频（无需标题）
./split_video.sh -i video.mp4 --crop-left 250 --crop-right 150 -l off

可以仅测试第一个片段吗？

可以！使用--test-first参数：

bash
./split_video.sh -i video.mp4 -T "标题" --test-first

这只会生成第一个片段，让你在处理整个视频前验证设置。

为什么在-i前使用-ss？

FFmpeg的参数位置很重要！在-i前使用-ss（输入 seeking）会将每个片段的时间线重置为t=0，确保滤镜正常工作。这比输出seeking更快更可靠。

---

📄 许可证

MIT许可证 - 详见 LICENSE

---

👤 作者

kekkooo86 - Docker Hub: https://hub.docker.com/r/kekkooo86 - GitHub: https://github.com/kekkooo86

---

📁 项目结构

video-splitter/
├── split_video.sh           # 主脚本（本地+Docker）
├── split_video_core.sh      # 核心函数（共享）
├── Dockerfile               # Docker镜像定义
├── docker-compose.yml       # Docker Compose配置
├── LICENSE                  # MIT许可证
├── README.md                # 本文件
├── CHANGELOG.md             # 版本历史
├── CONTRIBUTING.md          # 贡献指南

---

🔧 依赖

• https://hub.docker.com/r/jrottenberg/ffmpeg - 基础Docker镜像
• https://github.com/liberationfonts/liberation-fonts - 字体渲染

---

为内容创作者精心打造 ❤️