# videoToGIF

**Repository Path**: zizai-a/video-to-gif

## Basic Information

- **Project Name**: videoToGIF
- **Description**: 视频转GIF工具
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-02
- **Last Updated**: 2025-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 视频转GIF工具

这是一个功能强大的视频转GIF工具，带有现代化的图形用户界面。

## 功能特点

- 支持多种视频格式（MP4、AVI、MOV等）
- 现代化的图形用户界面
- 实时显示转换进度
- 可自定义输出路径
- 支持设置视频截取时间段
- 可自定义输出GIF尺寸
- 支持保持原始宽高比
- 实时预览GIF效果
- 优化的GIF压缩算法
- 显示输出文件大小

## 安装要求

1. Python 3.6或更高版本
2. 安装依赖包：
```bash
pip install -r requirements.txt
```

## 使用方法

1. 运行程序：
```bash
python video_to_gif.py
```

2. 基本使用步骤：
   - 点击"浏览"选择要转换的视频文件
   - 选择GIF文件的保存位置（默认与视频同名）
   - 设置转换参数（可选）：
     - 开始时间和结束时间
     - 目标尺寸（默认500x500）
     - 是否保持宽高比
   - 点击"开始转换"按钮
   - 等待转换完成

![输入图片说明](img%E5%BE%AE%E4%BF%A1%E6%88%AA%E5%9B%BE_20250402160859.png)


3. 预览功能：
   - 转换完成后，点击"预览GIF"按钮
   - 在新窗口中查看GIF效果
   - 可以调整预览窗口大小
   - 点击窗口右上角的关闭按钮停止预览

![输入图片说明](img%E5%BE%AE%E4%BF%A1%E6%88%AA%E5%9B%BE_20250402160928.png)


## 高级设置

- 时间设置：
  - 可以设置视频的起始和结束时间
  - 支持精确到小数点的时间值
  - 自动显示视频总时长

- 尺寸设置：
  - 默认输出尺寸为500x500像素
  - 支持自定义输出尺寸
  - 可选择是否保持原始宽高比
  - 保持宽高比时会自动填充黑色背景

- GIF优化：
  - 使用ffmpeg进行高质量转换
  - 优化的压缩算法
  - 256色调色板
  - 10fps的帧率设置

## 注意事项

- 转换大文件可能需要较长时间
- 确保有足够的磁盘空间
- 建议使用较短的视频片段进行转换，以获得更好的效果
- 保持宽高比时，输出GIF可能会有黑色边框
- 预览窗口可以自由调整大小，图像会自动适应

## 常见问题

1. 如果转换失败，请检查：
   - 视频文件是否完整
   - 是否有足够的磁盘空间
   - 输出路径是否有写入权限

2. 如果预览不显示，请检查：
   - GIF文件是否成功生成
   - 文件路径是否正确

3. 如果GIF文件过大，可以：
   - 缩短视频时长
   - 减小输出尺寸
   - 降低帧率（当前为10fps）