# video-screenshot

> 快速从视频中提取封面截图。

- Author: WangJie
- Repository: Andy-WJ/bilibili-media-ai
- Version: 20260201133847
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/Andy-WJ/bilibili-media-ai
- Web: https://mule.run/skillshub/@@Andy-WJ/bilibili-media-ai~video-screenshot:20260201133847

---

# Video Screenshot

快速从视频中提取封面截图。

## 功能

- **快速截图**: 从视频中提取指定时间点的截图
- **自动模式**: 自动提取开始、中间、结束三张封面图
- **自定义时间**: 支持指定任意时间点
- **高质量输出**: 使用 ffmpeg 生成高质量 JPEG 图片

## 使用方法

### 基本用法(自动提取3张截图)

```bash
/video-screenshot "/path/to/video.mp4"
```

这将提取:
- 视频开始帧 (00:00:00)
- 视频中间帧
- 视频结束帧

### 指定时间点

```bash
/video-screenshot "/path/to/video.mp4" --times 0,30,60,120
```

### 自定义输出目录和标题

```bash
/video-screenshot "/path/to/video.mp4" \
  --output-dir "./my_screenshots" \
  --title "MyVideo"
```

## 输出格式

成功时返回:

```json
{
  "success": true,
  "screenshots": [
    {
      "type": "start",
      "time": "00:00:00",
      "time_seconds": 0,
      "path": "/home/wj/demo/bilibili/output/screenshots/video_start.jpg"
    },
    {
      "type": "middle",
      "time": "00:05:55",
      "time_seconds": 355,
      "path": "/home/wj/demo/bilibili/output/screenshots/video_middle.jpg"
    },
    {
      "type": "end",
      "time": "00:11:51",
      "time_seconds": 711,
      "path": "/home/wj/demo/bilibili/output/screenshots/video_end.jpg"
    }
  ],
  "output_dir": "/home/wj/demo/bilibili/output/screenshots",
  "video_title": "video",
  "duration": 711
}
```

## 完整工作流

作为 B站视频处理流程的一部分:

```bash
# Step 1: 下载视频(包含视频)
/bilibili-media-downloader "https://www.bilibili.com/video/BVxxxxx" --video

# Step 2: 快速截图封面
/video-screenshot "/home/wj/demo/bilibili/output/video/BVxxxxx.mp4"

# Step 3: 继续其他处理...
```

## 性能

- **速度**: 通常 <5 秒完成3张截图
- **格式**: 高质量 JPEG (quality=2)
- **分辨率**: 保持视频原始分辨率

## 依赖

- ffmpeg (用于视频处理)
- Python 3.8+

## 注意事项

1. 确保视频文件存在且可访问
2. 输出目录会自动创建
3. 如果截图时间点超过视频时长,将自动调整