# window版提词器

**Repository Path**: bbullet/window-version-teleprompter

## Basic Information

- **Project Name**: window版提词器
- **Description**: 一个功能强大的Windows提词器应用程序，支持全局快捷键控制，适用于演讲、直播、视频录制等场景。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-08
- **Last Updated**: 2025-12-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Windows提词器

一个功能强大的Windows提词器应用程序，支持全局快捷键控制，适用于演讲、直播、视频录制等场景。

## 功能特性

### 核心功能
- ✅ **文本提词**：支持导入TXT和DOCX格式的文本文件
- ✅ **播放控制**：播放、暂停、重置功能
- ✅ **速度调节**：可调节提词速度（10-100）
- ✅ **全屏模式**：支持全屏显示，优化演示体验

### 高级功能
- ✅ **全局快捷键**：即使在后台也能控制提词器
- ✅ **配置保存**：自动保存用户配置
- ✅ **最近文件**：快速访问最近打开的文件
- ✅ **响应式设计**：适配不同屏幕尺寸

## 系统要求

- Windows 7/8/10/11
- Python 3.7或更高版本（源代码运行）
- .NET Framework 4.5或更高版本（打包版本）

## 安装方法

### 方法一：使用打包版本（推荐）

1. 从项目的`dist/teleprompter`目录获取打包好的应用程序
2. 将整个`teleprompter`文件夹复制到您的电脑上
3. 运行`teleprompter.exe`即可使用

### 方法二：从源代码运行

1. 克隆或下载项目源代码
2. 安装依赖：
   ```bash
   pip install python-docx pywin32
   ```
3. 运行应用程序：
   ```bash
   python teleprompter.py
   ```

## 使用方法

### 基本操作
1. **打开文件**：点击「文件」→「打开」，选择TXT或DOCX格式的文本文件
2. **开始提词**：点击播放按钮或使用快捷键
3. **调节速度**：使用速度滑块调整提词滚动速度
4. **全屏显示**：点击全屏按钮或使用快捷键

### 全局快捷键

提词器支持以下全局快捷键（即使在后台运行也能响应）：

| 快捷键组合 | 功能 |
|------------|------|
| ALT+SHIFT+SPACE | 播放/暂停提词器 |
| ALT+SHIFT+F11 | 切换全屏模式 |
| ALT+SHIFT+ESC | 退出全屏模式 |
| ALT+SHIFT+→ | 前进 |
| ALT+SHIFT+← | 后退 |

### 窗口快捷键

当应用程序获得焦点时，以下快捷键也可用：

| 快捷键 | 功能 |
|--------|------|
| SPACE | 播放/暂停提词器 |
| ESC | 退出全屏模式 |
| ↑ | 增加速度 |
| ↓ | 降低速度 |
| R | 重置提词器 |

## 配置

应用程序会自动保存配置文件`config.json`，包含以下设置：
- 提词速度
- 字体大小
- 窗口位置和大小
- 全屏设置

## 项目结构

```
teleprompter/
├── teleprompter.py      # 主程序文件
├── config.json          # 配置文件
├── recent_files.json    # 最近文件列表
├── README.md           # 项目说明文档
├── pack.bat            # 打包脚本
├── build.bat           # 构建脚本
├── build/              # 构建过程目录
├── dist/               # 打包输出目录
│   └── teleprompter/   # 可执行文件目录
├── .venv/              # Python虚拟环境（可选）
├── __pycache__/        # Python编译缓存
└── test_*.py           # 测试文件
```

## 开发说明

### 依赖项
- `tkinter`：GUI框架（Python标准库）
- `python-docx`：处理DOCX文件
- `pywin32`：实现全局快捷键（Windows系统专用）

### 打包应用

使用提供的`pack.bat`脚本生成可执行文件：

```bash
pack.bat
```

该脚本会自动完成以下操作：
1. 安装必要的依赖（pyinstaller, python-docx, pywin32）
2. 清理旧的构建文件
3. 使用PyInstaller生成可执行文件
4. 复制配置文件到输出目录

打包后的文件将位于`dist/teleprompter`目录下，包含完整的应用程序和所有依赖项。

## 常见问题

### Q: 全局快捷键不工作？
A: 请确保没有其他应用程序占用相同的快捷键组合。如果问题仍然存在，请尝试重启应用程序。

### Q: 无法打开DOCX文件？
A: 请确保已安装`python-docx`库：`pip install python-docx`，或使用打包版本的应用程序。

### Q: 应用程序崩溃？
A: 请查看`teleprompter.log`文件获取详细错误信息。

### Q: 只复制exe文件到其他电脑无法运行？
A: 是的，需要复制完整的`dist/teleprompter`文件夹，因为其中包含了所有依赖项（包括Python解释器、库文件和配置）。

### Q: 为什么会生成_internal文件夹？
A: 这是PyInstaller自动创建的，用于存储Python解释器、标准库和其他依赖项，确保应用程序可以独立运行。

## 版本信息

### v1.0.0 (当前版本)
- ✅ 基本提词功能
- ✅ 全局快捷键支持
- ✅ 全屏模式
- ✅ 速度调节
- ✅ 支持TXT和DOCX格式

## 许可证

本项目采用MIT许可证。

## 贡献

欢迎提交Issue和Pull Request！

## 联系方式

如有问题或建议，请通过以下方式联系：
- 创建Issue
- 发送邮件

---

**享受您的提词体验！** 🎤