# PreviewPlayer

**Repository Path**: xlizzard_admin/preview-player

## Basic Information

- **Project Name**: PreviewPlayer
- **Description**: PreviewPlayer

- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-12-22
- **Last Updated**: 2024-12-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PreviewPlayer

一个基于 Python 开发的视频播放器，具有强大的视频预览功能。支持将视频分段预览，通过网格视图快速定位到想要观看的位置。

## 特点

- 基于 VLC 的视频播放，支持多种视频格式
- 可配置的视频预览功能
  - 自定义预览数量
  - 自定义预览时长
  - 自定义预览尺寸
- 支持多种预览格式
  - WebP（推荐，体积小，支持动画）
  - GIF（兼容性好）
  - MP4（高质量）
- 预览网格视图
  - 动态预览
  - 点击跳转
  - 当前位置标记
- 完整的播放控制
  - 播放/暂停
  - 进度控制
  - 音量控制
  - 快捷键支持

## 安装要求

1. Python 3.8 或更高版本
2. 安装依赖：

    ```bash
    pip install -r requirements.txt
    ```

## 目录结构

    project_root/
        ├── PreviewPlayer.py     # 主程序
        ├── requirements.txt     # Python 依赖
        ├── README.md           # 说明文档
        ├── vlc/                # VLC 相关文件
        │   ├── libvlc.dll
        │   ├── libvlccore.dll
        │   └── plugins/
        └── ffmpeg/             # FFmpeg 工具
            ├── ffmpeg.exe
            └── ffprobe.exe

## 使用方法

1. 运行程序：

    ```bash
    python PreviewPlayer.py
    ```

2. 基本操作：
   - 点击"打开文件"选择视频文件
   - 使用播放控制按钮控制播放
   - 点击"预览面板"显示/隐藏预览功能

3. 预览功能：
   - 设置预览参数（数量、时长、尺寸）
   - 选择预览格式（webp/gif/mp4）
   - 点击"生成预览"开始生成预览
   - 点击预览缩略图跳转到对应位置

4. 快捷键：
   - 空格：播放/暂停
   - 左右方向键：快退/快进 5秒
   - 上下方向键：音量增/减
   - ESC：停止播放

## 注意事项

1. 首次生成预览可能需要一些时间，取决于视频长度和预览参数
2. 建议使用 WebP 格式，可以在保持较好质量的同时减小文件体积
3. 预览数量越多，生成时间越长，占用内存也越多
4. 程序会自动清理临时文件

## 开发环境

- Python 3.8+
- VLC 3.0.x
- FFmpeg 4.x

## 许可证

MIT License