# Shortcut_Sync_PotPlayer

一个用于 `PotPlayer` 多窗口联动控制的小工具。

运行后，程序会监听常用播放控制按键；当你在 `PotPlayer` 窗口，或本工具窗口中操作时，会把对应指令同步发送给其他已打开的 `PotPlayer` 窗口，适合双语字幕对照、多个版本同步播放、剪辑比对等场景。

## 功能特性

- 自动检测当前已打开的 `PotPlayer` 窗口
- 同步播放 / 暂停
- 同步快退 / 快进
- 同步小步进度调整：`Shift + Left / Right`
- 同步大步进度调整：`Ctrl + Left / Right`
- 工具窗口常驻顶层，方便查看当前状态
- 仅在你聚焦 `PotPlayer` 或本工具窗口时生效，避免误触

## 运行环境

- Windows
- Python 3.9+
- 已安装 `PotPlayer`

## 依赖安装

项目依赖：

- `keyboard`
- `pywin32`

安装命令：

```bash
pip install keyboard pywin32
```

> `tkinter` 为 Python 标准库的一部分，通常无需单独安装。

## 启动方式

在项目目录下运行：

```bash
python main.py
```

启动后会弹出一个置顶的小窗口，用于显示当前状态和快捷键说明。

## 使用说明

1. 先打开两个或以上的 `PotPlayer` 窗口。
2. 运行本工具。
3. 将焦点放在任意一个 `PotPlayer` 窗口，或本工具窗口。
4. 使用下列快捷键进行联动控制。

## 快捷键

| 快捷键 | 作用 |
| --- | --- |
| `Space` | 同步播放 / 暂停 |
| `Left` | 同步后退 |
| `Right` | 同步前进 |
| `Shift + Left` | 同步小步后退 |
| `Shift + Right` | 同步小步前进 |
| `Ctrl + Left` | 同步大步后退 |
| `Ctrl + Right` | 同步大步前进 |

## 同步逻辑

- 如果当前焦点在某个 `PotPlayer` 窗口上，按键会同步到“其他” `PotPlayer` 窗口
- 如果当前焦点在本工具窗口上，按键会同步到“全部” `PotPlayer` 窗口
- 如果当前没有聚焦 `PotPlayer` 或本工具窗口，程序不会执行同步
- 当只打开一个 `PotPlayer` 窗口时，不会进行同步

## 注意事项

- 本工具仅支持 Windows
- 仅对窗口类名为 `PotPlayer64` 或 `PotPlayer` 的窗口生效
- 部分快捷键监听场景下，可能需要以管理员身份运行 Python 或终端
- 本工具发送的是窗口消息和按键消息，实际步进时长取决于你在 `PotPlayer` 中的快捷键设置

## 项目结构

```text
.
├── main.py     # 主程序
├── README.md   # 项目说明
└── LICENSE     # 开源许可
```

## 许可证

本项目采用 [GPL-3.0](./LICENSE) 许可证。