# FastSRT

**Repository Path**: codekpy/fast-srt

## Basic Information

- **Project Name**: FastSRT
- **Description**: 一个纯粹的FastWhisper字幕转化工具
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-25
- **Last Updated**: 2026-05-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FastSRT

一个基于 PySide6 的现代化 Fast-Whisper 字幕生成工具，支持玻璃态背景和高级界面设计。

## 功能特性

- ✅ 支持 fast-whisper 和 whisper 两种后端
- ✅ 可自定义模型存储地址
- ✅ 支持用户自行下载模型
- ✅ 模型格式自动识别和验证
- ✅ 现代化 PySide6 GUI
- ✅ 玻璃态 (Acrylic/Blur) 背景效果
- ✅ 无边框窗口设计
- ✅ 侧边导航栏
- ✅ 实时进度显示和日志输出
- ✅ 多语言支持
- ✅ SRT/VTT/ASS/TXT格式输出
- ✅ 亮色/暗色主题切换
- ✅ 文件拖放支持
- ✅ 配置持久化

## 系统要求

- **Python**: 3.9+
- **操作系统**: Windows 10+ (推荐，玻璃态效果最佳)
- **GPU**: 可选 (CUDA 支持可显著提升性能)
- **内存**: 至少 4GB (根据模型大小需求不同)

## 安装

### 1. 克隆或下载项目

```bash
git clone <repository-url>
cd fast-srt
```

### 2. 运行环境设置脚本

```bash
python setup_env.py
```

这将:
- 创建 Python 虚拟环境
- 安装所有依赖包

### 3. 激活虚拟环境

**Windows:**
```bash
.venv\Scripts\activate
```

**Linux/Mac:**
```bash
source .venv/bin/activate
```

### 4. 准备模型

#### faster-whisper 模型

1. 从 Hugging Face 下载模型: https://huggingface.co/Systran
2. 解压到模型文件夹

目录结构:
```
models/
├── tiny/
│   ├── config.json
│   ├── model.bin
│   └── preprocessor_config.json
└── base/
    └── ...
```

#### whisper 模型

1. 下载 `.pt` 模型文件
2. 直接放到模型文件夹

目录结构:
```
models/
├── tiny.pt
├── base.pt
└── ...
```

## 使用说明

### 启动应用

```bash
python run.py
```

### 基本流程

1. **设置模型文件夹**
   - 打开设置页面
   - 指定模型文件夹路径
   - 刷新模型列表

2. **选择文件**
   - 在首页拖放文件到指定区域
   - 或点击"选择文件"按钮

3. **配置参数**
   - 选择模型
   - 选择输出格式 (SRT/VTT/ASS/TXT)
   - 选择输出文件夹

4. **开始转换**
   - 点击"开始转换"按钮
   - 等待转换完成
   - 查看日志输出

### 模型选择建议

| 使用场景 | 推荐模型 |
|---------|---------|
| 日常使用 | small / medium |
| 生产环境 | medium / large-v3 |
| 实时应用 | tiny / base |
| 高精度需求 | large-v3 |

## 项目结构

```
fast-srt/
├── .venv/                    # Python 虚拟环境
├── src/
│   ├── main.py              # 应用入口
│   ├── config.py            # 配置管理
│   ├── model_manager.py     # 模型管理
│   ├── subtitle_generator.py # 字幕生成
│   ├── gui/                 # GUI 组件
│   │   ├── main_window.py   # 主窗口
│   │   ├── navigation.py    # 导航栏
│   │   ├── pages/           # 页面
│   │   ├── components/      # 组件
│   │   ├── dialogs/         # 对话框
│   │   ├── effects/         # 效果
│   │   ├── theme/           # 主题
│   │   └── styles/          # 样式
│   └── utils/               # 工具函数
├── config/
│   └── settings.json        # 配置文件
├── models/                  # 模型文件夹
├── docs/
│   └── model_guide.md       # 模型指南
├── requirements.txt         # 依赖列表
├── setup_env.py            # 环境设置脚本
└── run.py                  # 启动脚本
```

## 依赖

主要依赖:
- PySide6 >= 6.6.0
- faster-whisper >= 1.0.0
- openai-whisper >= 20231117
- torch >= 2.0.0

完整依赖列表请查看 [requirements.txt](requirements.txt)

## 常见问题

### Q: 为什么启动后看不到模型？
A: 请确保:
1. 已在设置页面指定模型文件夹
2. 模型文件格式正确
3. 点击了"刷新模型列表"按钮

### Q: 转换速度很慢怎么办？
A: 可以尝试:
1. 使用 faster-whisper 后端
2. 选择较小的模型 (如 small)
3. 使用 GPU (CUDA) 加速

### Q: 支持哪些音视频格式？
A: 支持常见格式:
- 音频：MP3, WAV, FLAC, M4A, OGG, WMA, AAC
- 视频：MP4, AVI, MKV, MOV, WMV, FLV, WEBM

### Q: 玻璃态效果不显示？
A: 玻璃态效果需要:
1. Windows 10 或更高版本
2. 启用窗口组合 (DWM)
3. 显卡驱动支持

## 开发

### 运行开发版本

```bash
python setup_env.py
python run.py
```

### 构建发布版本

```bash
# TODO: 添加 PyInstaller 打包脚本
```

## 许可证

本项目采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件。

## 贡献

欢迎提交 Issue 和 Pull Request!

## 致谢

- [OpenAI Whisper](https://github.com/openai/whisper)
- [faster-whisper](https://github.com/guillaumekln/faster-whisper)
- [PySide6](https://doc.qt.io/qtforpython-6/)

## 联系方式

如有问题或建议，请通过以下方式联系:
- 提交 Issue
- 发送邮件至: support@fastsrt.com (示例邮箱)