# mvptimer

**Repository Path**: michaelwooo/mvptimer

## Basic Information

- **Project Name**: mvptimer
- **Description**: MVP Timer 是一个用于管理和跟踪 MVP 倒计时的桌面应用程序。用户可以设置计时器、查看倒计时，并在计时结束时接收通知。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-10-20
- **Last Updated**: 2024-10-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MVP Timer

MVP Timer 是一个用于管理和跟踪 MVP 倒计时的桌面应用程序。用户可以设置计时器、查看倒计时，并在计时结束时接收通知。

## 功能

- **计时器管理**：为每个 MVP 设置计时器，并在计时结束时接收通知。
- **编辑功能**：通过内置的 JSON 编辑器，可以编辑 MVP 的详细信息。
- **自动保存和恢复**：应用程序会自动保存计时器状态，并在重启时恢复。

## 安装

1. 克隆此仓库：

   ```bash
   git clone https://gitee.com/michaelwooo/mvptimer.git
   cd mvp-timer
   ```

2. 安装依赖项：

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

3. 运行应用程序：

   ```bash
   python main.py
   ```

## 打包

使用 PyInstaller 打包应用程序：
   ```bash
   pyinstaller MVPTimer.spec
   ```

## 注意事项

**Windows7 系统需要用 Python 3.8.10版本编译**

## 使用步骤

1. **启动应用程序**：
   - 运行 MVP Timer 应用程序，主窗口将显示所有可用的 MVP 计时器。

2. **设置计时器**：
   - 点击某个 MVP 的图形视图以启动计时器。再次点击可以停止计时器。

3. **编辑 MVP 信息**：
   - 点击“编辑MVP”按钮打开 JSON 编辑器，可以在此编辑 MVP 的详细信息。
   - 拖动 ID 前面的序号行时，可交换两个行的排序。

4. **刷新界面**：
   - 点击“刷新界面”按钮以重新加载应用程序，应用任何更改。

5. **输入击杀时间**：
   - 右键点击某个 MVP 的图形视图，输入 BOSS 被击杀的时间以调整计时器。

6. **通知**：
   - 当计时器结束时，应用程序将显示通知提醒。

## 注意事项

- **文件路径**：确保 `mvp.json` 文件位于应用程序的同一目录中，以便正确加载 MVP 数据。
- **配置列和行**：`config.json` 文件可配置每行每列分别显示多少个 MVP 数据。
- **权限**：确保应用程序有权限在当前目录中创建和写入 `timer_state.json` 文件。
- **格式要求**：输入时间时，请使用 `hh:mm` 格式。

## 常见问题

- **找不到 mvp.json 文件**：请确保 `mvp.json` 文件存在于应用程序的同一目录中。
- **时间格式错误**：输入时间时，请确保使用正确的格式（例如 `1230` 或 `12:30`）。

## 贡献

欢迎贡献！请 fork 此仓库并提交 pull request。

## 许可证

此项目使用 MIT 许可证。有关详细信息，请参阅 [LICENSE](LICENSE) 文件。