forked from Xingshu/Shortcut_Sync_PotPlayer
94 lines
2.5 KiB
Markdown
94 lines
2.5 KiB
Markdown
# 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) 许可证。
|
|
|