Metadata-Version: 2.4
Name: shortcutkey
Version: 5.0.0
Summary: 通过快捷键打开指定软件的工具
Home-page: https://github.com/ZBIGBEAR/shortcutkey
Author: Alex
Author-email: 664141154@qq.com@example.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pynput>=1.7.6
Requires-Dist: pyyaml>=6.0
Requires-Dist: pyinstaller>=5.0.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# shortcutkey

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

## 功能特性

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

## 安装

```bash
pip3 install shortcutkey
```

## 权限授权提醒

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

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

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

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

### Linux系统
- 可能需要安装`xdotool`工具以支持窗口管理功能
  ```bash
  # Ubuntu/Debian
  sudo apt-get install xdotool
  
  # CentOS/Fedora
  sudo yum install xdotool
  ```

## 使用方法

### 1. 启动程序

```bash
shortcutkey
```

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

### 2. 配置快捷键

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

```bash
shortcutkey --config
```

在配置界面中，您可以：
- 通过输入应用程序的数字编号选择应用
- 为每个应用指定自定义快捷键
- 管理已配置的快捷键（添加、修改或删除）

### 3. 查看帮助

```bash
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
