# hotkey

**Repository Path**: TitaniumCores/hotkey

## Basic Information

- **Project Name**: hotkey
- **Description**: 一个让win10/win11在开机后能够只启动想要启动的应用，通常用于工控机、展示大屏等，只需按下alt+f7。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-16
- **Last Updated**: 2025-10-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Python, 不显示桌面, 启动程式, 快捷操作

## README

# 快捷键登录与系统操作工具（Windows 7/10）

本工具用 Python 实现，支持在任何界面按 `Alt+F7` 呼出登录界面，登录后通过键盘操作进入功能菜单：

- `启动程式`：设置注册表 Winlogon 的 `Shell` 值（需要管理员权限）。
- `打开桌面`：启动 `explorer.exe`。
- `鼠标属性`：打开鼠标属性面板。
- `注册表`：打开注册表编辑器。
- `关机`：立即关机（需要管理员权限）。
- `退出程式`：关闭本软件当前窗口。

## 环境要求

- Windows 7 或 Windows 10。
- Python 3.7+。
- 依赖：`keyboard`（用于全局热键）。

## 安装依赖

```bash
pip install -r requirements.txt
```

> 提示：在部分系统上，`keyboard` 监听全局按键可能需要以管理员身份运行。

## 运行

```bash
python main.py
```

> 若要修改注册表或执行关机，建议以管理员身份运行。

## 使用说明

- 在任何界面按 `Alt+F7` 弹出登录窗口。
- 使用 `Tab` 在控件之间切换，`Enter` 执行，`Esc` 取消或返回。
- 登录成功后进入菜单窗口，同样支持 `Tab/Enter` 全程无鼠标操作。

### 修改用户名与密码

你可以通过两种方式修改登录账号信息：

- 在应用菜单中点击“修改用户名与密码”，在弹窗中输入并保存；
- 或者直接编辑项目根目录下的 `config.json`：

```json
{
  "username": "admin",
  "password": "123456"
}
```

保存后立即生效。应用会将修改持久化到 `config.json` 中，保留其他配置项（如 `app_name`）。

### 设置启动程式（Shell）

在菜单中选择“启动程式”，弹出路径输入窗口：

- 填写绝对路径（如 `C:\\windows\\dfser\\fisfd.exe`），或直接填 `explorer.exe`。
- 点击“确认”后写入注册表：
  `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon` 的 `Shell` 值。
- 修改后需重启系统生效。

> 写入注册表需要管理员权限，否则会提示权限不足。

### 菜单项动作

- 打开桌面：启动 `explorer.exe`。
- 鼠标属性：执行 `rundll32.exe shell32.dll,Control_RunDLL main.cpl`。
- 注册表：执行 `regedit.exe`。
- 关机：执行 `shutdown /s /t 0`（需管理员权限）。

## 打包为 EXE

可使用 PyInstaller（需先安装）：

```bash
pip install pyinstaller
pyinstaller --onefile --noconsole main.py
```

生成的可执行文件位于 `dist/<app_name>.exe`。你可以在 `config.json` 中通过 `app_name` 字段控制生成的可执行文件名称：

```json
{
  "username": "admin",
  "password": "123456",
  "app_name": "MyTool"
}
```

若使用 `main.spec` 打包，将直接读取上述配置：

```bash
pyinstaller main.spec
```

建议右键“以管理员身份运行”。

## 注意事项

- 在极少数环境下，全局热键需要管理员权限或可能被安全软件拦截。
- 修改 Shell 值会影响系统登录后的默认外壳（桌面）。设为非 `explorer.exe` 时，开机将直接运行指定程序而非桌面。