# PPT倒计时工具

**Repository Path**: ike_lin/ppt-countdown-tool

## Basic Information

- **Project Name**: PPT倒计时工具
- **Description**: 一款轻量级 Windows 桌面倒计时工具，专为 PPT 演讲、答辩、会议等场景设计。支持倒计时/正计时双模式、自定义样式、多屏适配、智能预警提醒。无广告、无弹窗、无后台驻留，纯净轻量，助您精准掌控演示节奏。
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-03
- **Last Updated**: 2026-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PPT 倒计时工具

> 一款轻量级 Windows 桌面倒计时助手，专为 PPT 演讲、答辩、会议等场景设计。

![Python](https://img.shields.io/badge/Python-3.8%2B-blue)
![PySide6](https://img.shields.io/badge/PySide6-6.x-green)
![License](https://img.shields.io/badge/License-MIT-yellow)

---

## 📖 简介

PPT 倒计时工具是一款**纯净、轻量、无广告**的辅助软件，帮助您精准掌控演示节奏。支持**倒计时/正计时双模式**、**自定义视觉样式**、**多屏适配**、**智能预警**及 **Web 远程控制**，无论是线下演讲还是线上会议，都能让您从容不迫。

---

## ✨ 功能特性

- **双模式计时**：倒计时（预设时长递减）与正计时（从零递增），自由切换。
- **自定义预设时间**：支持时分秒精确设定，并提供常用快捷模板（3/5/8/10/15 分钟）。
- **个性化样式**：自由调整字体、字号、字色、背景色/透明度、边框宽度/颜色，实时生效。
- **智能提醒**：
  - **预警**：剩余时间低于阈值时，数字颜色变为橙色并闪烁（阈值可调，设为0即关闭）。
  - **超时**：倒计时归零或正计时到达预设时间后，数字红色闪烁 + 背景闪红 + 语音播报（可选） + 弹窗提醒（可选）。
- **窗口置顶与多屏**：悬浮窗始终置顶，支持指定屏幕显示，可拖动、调整窗口大小和透明度。
- **全局热键**：所有操作均可通过快捷键完成（开始/暂停/重置/切换模式/显示隐藏），且支持自定义修改。
- **控制面板**：独立面板集中控制所有功能，无需记忆快捷键。
- **Web 远程控制**：内置 Web 服务器，手机或电脑浏览器即可远程操控，支持二维码扫码访问。
- **绿色纯净**：无广告、无弹窗、无后台驻留、不收集隐私，所有配置本地存储。

---

## 🖥️ 运行环境

- **操作系统**：Windows 7 / Windows 10 / Windows 11（32/64 位）
- **Python 版本**：3.8 及以上（若直接运行源码）
- **依赖库**：PySide6, keyboard, pywin32, qrcode

---

## 📦 安装与运行

### 方式一：使用已打包的 exe（推荐普通用户）

从 [Releases](https://gitee.com/ike_lin/ppt-countdown-tool/releases) 下载最新版本的 `PPT倒计时.exe`，双击即可运行，无需安装 Python。

### 方式二：直接运行 Python 源码

1. 克隆或下载本仓库源码。
2. 安装依赖：
   ```bash
   pip install PySide6 keyboard pywin32 qrcode
   ```
3. 运行主程序：
   ```bash
   python countdown.py
   ```

## 🚀 使用说明

### 基本操作

- **右键点击悬浮窗** → 可打开控制面板或设置。
- **左键拖动**：可任意移动悬浮窗位置。
- **控制面板**：提供开始/暂停、重置、切换模式、关闭弹窗、快速模板、样式调整、窗口设置、预警阈值等全部功能。
- **设置窗口**：可调整预设时间、预警阈值、显示系统时间（空闲时）、自定义模板列表、全局热键、Web 远程控制等。

### 全局热键（默认）

| 功能 | 快捷键 |
|------|--------|
| 开始计时 | `Ctrl + Alt + S` |
| 暂停/继续 | `Ctrl + Alt + P` |
| 重置 | `Ctrl + Alt + R` |
| 切换正/倒计时 | `Ctrl + Alt + M` |
| 显示/隐藏悬浮窗 | `Ctrl + Alt + H` |

> 所有热键可在“设置 → 快捷键”中自定义修改。

### Web 远程控制

1. 打开设置 → **Web远程控制**。
2. 勾选“启用Web远程控制”，服务自动启动。
3. 在手机或电脑浏览器中访问显示的地址（如 `http://192.168.1.100:8999`），即可通过网页控制计时器。
4. 支持二维码扫码访问，方便手机快速连接。

---

## 🛠️ 打包为 exe（给开发者）

项目提供了 PyInstaller 打包脚本，您可按需生成可执行文件。

### 快速打包

```bash
# 安装打包工具
pip install pyinstaller

# 执行打包（推荐使用 --onedir 以提升启动速度）
pyinstaller --onedir --windowed --uac-admin --name="PPT倒计时" countdown.py
```
### 优化启动速度与体积

- 使用 `--onedir` 模式（非单文件）启动更快，体积更小。
- 排除未使用的 Qt 模块：通过 `--exclude-module` 或编辑 `.spec` 文件，可大幅减小体积。
- 启用 UPX 压缩：安装 UPX 后，添加 `--upx-dir` 参数。

---

## ⚙️ 配置文件

所有用户配置保存在 `%USERPROFILE%\.ppt_timer_config.json`，删除该文件可恢复默认设置。

---

## ❓ 常见问题

### 1. 热键无法使用？
- 确保以**管理员身份**运行程序（右键 → 以管理员身份运行）。
- 检查是否有其他软件占用了相同热键。

### 2. Web 远程控制无法访问？
- 检查防火墙是否允许程序访问网络（或暂时关闭防火墙测试）。
- 确保手机与电脑在同一局域网。
- 检查端口是否被占用，可更换端口再试。

### 3. 运行提示“无法注册热键”？
- 以管理员身份运行生成的 exe。

### 4. 如何完全退出程序？
- 右键悬浮窗 → **退出**，或点击系统托盘图标 → **退出**。

### 5. 控制面板关闭后如何重新打开？
- 右键悬浮窗 → **控制面板**，或点击系统托盘 → **控制面板**。

---

## 📄 开源协议

本项目采用 [MIT License](LICENSE) 开源协议，您可以自由使用、修改和分发，但需保留版权声明。

---

## 🤝 贡献与反馈

- **Gitee 仓库**：[https://gitee.com/ike_lin/ppt-countdown-tool](https://gitee.com/ike_lin/ppt-countdown-tool)
- **微信公众号**：一个运维
- 欢迎提交 Issue 和 Pull Request，共同完善本项目。

---

**享受每一次精准的演示！** ⏱️