# video-preview-manager

**Repository Path**: mengfanding/video-preview-manager

## Basic Information

- **Project Name**: video-preview-manager
- **Description**: 一个快速把本地视频生成动图预览并且可以播放整理视频源文件的工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-21
- **Last Updated**: 2025-05-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 视频预览工具 (Video Preview Tool)

一个基于Flask的视频预览和管理工具，支持视频预览图生成、收藏管理、视频播放等功能。

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/)
[![Flask](https://img.shields.io/badge/flask-2.0+-lightgrey.svg)](https://flask.palletsprojects.com/)

## ✨ 功能特性

- 🎥 自动生成视频预览图
- 📱 响应式设计，支持移动端访问
- ⭐ 视频收藏管理
- 🔍 视频扫描和预览
- 🎯 支持多种排序方式（ID、时长、文件名）
- 🎨 现代化UI界面
- 🌙 深色主题设计
- 📊 分页显示
- 🗑️ 视频删除功能
- 🎮 视频播放器

## 🚀 快速开始

### 环境要求

- Python 3.8+
- FFmpeg
- 现代浏览器（支持HTML5）

### 安装步骤

1. 克隆仓库
```bash
git clone https://github.com/mengfanding/video-preview-manager.git
cd video-preview-manager
```

2. 创建虚拟环境（可选但推荐）
```bash
python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或
venv\Scripts\activate  # Windows
```

3. 安装依赖
```bash
pip install -r requirements.txt
```

4. 配置
编辑 `config.yml` 文件，设置视频目录和其他配置项：
```yaml
video_dir: /path/to/your/videos
preview_dir: /path/to/preview/images
```

5. 运行应用
```bash
python app.py
```

访问 `http://localhost:5000` 即可使用。

## 📦 项目结构

```
video-preview-manager/
├── app.py              # 主应用文件
├── config.py           # 配置加载
├── config.yml          # 配置文件
├── database.py         # 数据库操作
├── video_processor.py  # 视频处理
├── requirements.txt    # 项目依赖
├── templates/          # HTML模板
│   ├── index.html     # 主页
│   └── play.html      # 播放页面
└── static/            # 静态资源
```

## 🔧 配置说明

在 `config.yml` 中可以配置以下选项：

- `video_dir`: 视频文件目录
- `preview_dir`: 预览图保存目录
- `preview_count`: 每个视频生成的预览图数量
- `preview_interval`: 预览图时间间隔（秒）
- `preview_size`: 预览图尺寸
- `allowed_extensions`: 支持的视频格式

## 🎯 使用说明

1. 扫描视频
   - 点击"扫描新视频"按钮开始扫描
   - 系统会自动生成预览图

2. 视频管理
   - 支持按ID、时长、文件名排序
   - 可以收藏喜欢的视频
   - 支持删除不需要的视频

3. 视频播放
   - 点击视频卡片进入播放页面
   - 支持基本的播放控制
   - 可以返回列表或删除视频

## 📷 预览图

![web](doc/images/web.png)

![mobile](doc/images/mobile.png)

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 📝 开源协议

本项目采用 MIT 协议 - 查看 [LICENSE](LICENSE) 文件了解详情

## 🙏 致谢

- [Flask](https://flask.palletsprojects.com/)
- [Bootstrap](https://getbootstrap.com/)
- [Font Awesome](https://fontawesome.com/)
- [FFmpeg](https://ffmpeg.org/)

## 📮 联系方式

如有问题或建议，欢迎通过以下方式联系：

- 提交 [Issue](https://github.com/mengfanding/video-preview-manager/issues)

---

如果这个项目对你有帮助，欢迎给个 ⭐️ Star 支持一下！