Shortcut_Sync_PotPlayer

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

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

功能特性

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

运行环境

• Windows
• Python 3.9+
• 已安装 PotPlayer

依赖安装

项目依赖：

• keyboard
• pywin32

安装命令：

pip install keyboard pywin32

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

启动方式

在项目目录下运行：

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 中的快捷键设置

项目结构

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

许可证

本项目采用 GPL-3.0 许可证。