shortcutkey

一个功能强大的快捷键管理工具，允许用户通过自定义快捷键快速打开、切换和管理指定的软件。

功能特性

• 通过自定义快捷键快速打开指定软件
• 智能窗口管理：当对应的程序已处于前台时，按快捷键将其最小化
• 命令行交互式配置快捷键，支持搜索和分页浏览应用列表
• 应用选择界面支持上下箭头键快速切换页面
• 多语言支持，提供友好的用户界面
• 开机自启动功能，无需手动启动
• 后台运行模式，不干扰正常工作
• 跨平台支持，兼容Windows、macOS和Linux
• 详细的日志记录，便于问题排查

安装

pip3 install shortcutkey

权限授权提醒

macOS系统

在首次运行程序时，macOS会请求以下权限，请务必授予，否则程序可能无法正常工作：

• 辅助功能权限：用于监听全局快捷键
• 屏幕录制权限：用于检测当前活动窗口（部分功能需要）

请按照以下步骤授予权限：

1. 打开系统偏好设置 → 安全性与隐私
2. 选择"隐私"标签页
3. 在左侧列表中选择"辅助功能"，点击锁图标解锁并添加应用
4. 在左侧列表中选择"屏幕录制"，点击锁图标解锁并添加应用
5. 重新启动应用以应用权限更改

Windows系统

• 以管理员身份运行程序，确保快捷键监听功能正常工作

Linux系统

• 可能需要安装xdotool工具以支持窗口管理功能

  # Ubuntu/Debian
  sudo apt-get install xdotool
  
  # CentOS/Fedora
  sudo yum install xdotool
  

使用方法

1. 启动程序

shortcutkey

程序将在后台运行，监听配置的快捷键。您可以在任务管理器或活动监视器中看到它在运行。

2. 配置快捷键

首次运行时，程序会引导您配置快捷键。您也可以通过以下方式重新配置：

shortcutkey --config

在配置界面中，您可以：

• 通过输入应用程序的数字编号选择应用
• 为每个应用指定自定义快捷键
• 管理已配置的快捷键（添加、修改或删除）

3. 查看帮助

shortcutkey -h

配置文件

配置文件位于用户目录下的 .shortcutkey/config.yaml。您可以手动编辑此文件来修改快捷键配置。

日志文件位于用户目录下的 .shortcutkey/log/ 目录中，可以用于排查问题。

高级功能

智能窗口管理

当您按下快捷键时，如果对应的程序已经在前台运行，程序将自动将其最小化，实现快速切换和窗口管理。

开机自启动

程序提供开机自启动功能，您可以在配置过程中选择启用或禁用。

多语言支持

程序支持多种语言，将根据系统语言自动选择最合适的界面语言。

故障排除

快捷键无响应

1. 检查是否已授予必要的系统权限（特别是macOS系统）
2. 确认快捷键没有被其他程序占用
3. 查看日志文件，了解可能的错误信息

窗口最小化功能不正常

1. Windows系统：确保已安装pywin32库
2. Linux系统：确保已安装xdotool工具
3. 某些应用程序可能有特殊的窗口管理行为，可能不支持自动最小化

支持的系统

• Windows 7/8/10/11
• macOS 10.14及以上
• Linux（主要发行版）

许可证

MIT