# GameAlwaysEnglish

**Repository Path**: LvTree/GameAlwaysEnglish

## Basic Information

- **Project Name**: GameAlwaysEnglish
- **Description**: Game Always English 是一个自动切换输入法的工具，专为游戏玩家设计。它能够在您进入指定的游戏或应用程序时，自动将输入法切换为英文，避免因输入法切换不及时导致的游戏操作问题。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-06-11
- **Last Updated**: 2025-08-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Game Always English

## 项目简介

Game Always English 是一个自动切换输入法的工具，专为游戏玩家设计。它能够在您进入指定的游戏或应用程序时，自动将输入法切换为英文，避免因输入法切换不及时导致的游戏操作问题。

## 主要功能

- 自动监控前台窗口，当检测到目标程序时切换为英文输入法
- 支持通过进程名或窗口标题匹配目标程序
- 系统托盘运行，占用资源少
- 支持开机自启动
- 可自定义配置目标程序列表

## 系统要求

- Windows 10/11
- Python 3.8 或更高版本（如果从源码运行）

## 使用方法

windows右键菜单 -> 新建 -> 快捷方式 -> 输入: `你的python\pythonw.exe f:/个人项目/GameAlwaysEnglish/main.py`

这里注意要用pythonw.exe，而不是python.exe，否则会弹出命令行窗口

然后`winr + r` -> 输入: `shell:startup`, 将快捷方式拖到启动文件夹中

## 使用说明

1. 首次运行时，程序会在系统托盘创建一个图标
2. 右键点击托盘图标可以看到以下选项：
   - 状态：显示当前运行状态
   - 显示日志：打开日志文件
   - 重载配置：重新加载配置文件
   - 重启服务：重启监控服务
   - 退出：退出程序

## 配置说明

配置文件为 `config.json`，可以根据需要修改：

```json
{
  "target_programs": [
    {
      "name": "steam.exe",
      "match_type": "process",
      "pattern": "exact",
      "description": "Steam游戏平台"
    },
    {
      "name": "game",
      "match_type": "window_title",
      "pattern": "contains",
      "description": "包含'game'的窗口标题"
    }
  ],
  "log_settings": {
    "level": "INFO",
    "max_size_mb": 10,
    "backup_count": 3,
    "log_file": "game_always_english.log"
  },
  "check_interval_ms": 500,
  "startup_enabled": true,
  "minimize_to_tray": true
}
```

### 配置项说明

- `target_programs`: 目标程序列表
  - `name`: 程序名称或窗口标题
  - `match_type`: 匹配类型，可选 `process`（进程名）或 `window_title`（窗口标题）
  - `pattern`: 匹配模式，可选 `exact`（精确匹配）或 `contains`（包含匹配）
  - `description`: 描述信息（可选）
- `log_settings`: 日志设置
  - `level`: 日志级别，可选 `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`
  - `max_size_mb`: 日志文件最大大小（MB）
  - `backup_count`: 保留的日志文件数量
  - `log_file`: 日志文件名
- `check_interval_ms`: 检查间隔（毫秒）
- `startup_enabled`: 是否开机自启
- `minimize_to_tray`: 是否最小化到托盘

## 许可证

MIT License

## 联系方式

如有问题或建议，请提交 [Issue](https://github.com/yourusername/GameAlwaysEnglish/issues)