byted-util-video-editor

Files (3)

• LICENSE
• SKILL.md
• video_editor.py · scripts/

SKILL.md (first lines)

# Video Editor - 视频编辑器

## 适用场景

当需要进行视频后期处理时使用此技能，包括：

- **合并多个视频**：将多个分镜视频合成一个完整视频
- **添加音频**：为视频添加旁白、背景音乐等音频轨道
- **合并音频**：将多个音频文件按时间轴合并成一个完整音频
- **生成字幕**：生成 SRT 格式的字幕文件
- **烧录字幕**：将字幕硬编码到视频中
- **视频制作**：短视频、宣传片、教学视频的后期合成

## 功能特性

### 1. 合并多个视频

- 支持 2+ 个视频文件拼接
- 自动处理视频编码和格式转换
- 保持原始视频质量
- **自动保留原始视频的背景音乐**

### 2. 添加音频轨道

- 支持添加旁白配音
- 支持添加背景音乐
- 可调节音频音量（0.0-2.0 倍）
- 可调节原始视频背景音乐音量（0.0-2.0 倍）
- 背景音乐和对白音频自动混合

### 3. 合并多个音频

- 支持将多个音频文件按时间轴合并成一个完整音频
- 每个音频可以指定自己的开始时间（秒）
- 使用 amix 滤镜平滑混合音频

### 4. 生成字幕

- 支持生成标准 SRT 格式字幕文件
- 支持多段字幕，每段有独立的开始/结束时间
- UTF-8 编码，支持中文字幕

### 5. 烧录字幕

- 将 SRT 字幕硬编码到视频中
- 需要 ffmpeg 编译时包含 libass（subtitles 滤镜）支持
- 如当前环境不支持，可使用其他视频编辑工具（如剪映等）烧录字幕

### 6. 灵活的操作模式

- **merge 模式**：合并多个视频（可同时添加音频）
- **add-audio 模式**：为现有视频添加音频
- **merge-audios 模式**：合并多个音频文件
- **generate-srt 模式**：生成 SRT 字幕文件
- **burn-subtitles 模式**：烧录字幕到视频

## 系统要求

### 安装 ffmpeg

**Ubuntu/Debian：**

```bash
sudo apt install ffmpeg
```

**macOS：**

```bash
brew install ffmpeg
```

**验证安装：**

```bash
ffmpeg -version
```

## 使用步骤

### 模式 1：合并多个视频

**基本用法：**

```bash
python scripts/video_editor.py output.mp4 --videos video1.mp4 video2.mp4 video3.mp4
```

**带音频合并：**

```bash
python scripts/video_editor.py output.mp4 --videos v1.mp4 v2.mp4 v3.mp4 --audio narration.mp3
```

**调整音频音量：**

```bash
# 对白音频音量为 0.8 倍（降低 20%）
python scripts/video_editor.py output.mp4 --videos v1.mp4 v2.mp4 --audio dialogue.mp3 --volume 0.8

# 对白音频音量为 1.5 倍（提高 50%）
python scripts/video_editor.py output.mp4 --videos v1.mp4 v2.mp4 --audio dialogue.mp3 --volume 1.5

# 同时调整背景音乐音量为 0.5 倍
python scripts/video_editor.py output.mp4 --videos v1.mp4 v2.mp4 --audio dialogue.mp3 --volume 0.8 --bg-volume 0.5
```

### 模式 2：为现有视频添加音频

**基本用法：**

```bash
python scripts/video_editor.py output.mp4 --video input.mp4 --audio narration.mp3 --mode add-audio
```

**调节音量：**

```bash
python scripts/video_editor.py output.mp4 --video input.mp4 --audio background.mp3 --volume 0.5 --mode add-audio

From bytedance/agentkit-samples, Apache-2.0.

More from bytedance/agentkit-samples