ime_shift_fix 0.1.0

Protect IME mode while selecting text with Shift+Click on Windows.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

# IME Shift Fix


[![Crates.io](https://img.shields.io/crates/v/ime_shift_fix.svg)](https://crates.io/crates/ime_shift_fix)
[![Docs.rs](https://docs.rs/ime_shift_fix/badge.svg)](https://docs.rs/ime_shift_fix)
[![CI](https://github.com/ou6326/ime-shift-fix/actions/workflows/ci.yml/badge.svg)](https://github.com/ou6326/ime-shift-fix/actions/workflows/ci.yml)
[![License](https://img.shields.io/crates/l/ime_shift_fix.svg)](https://github.com/ou6326/ime-shift-fix#license)

Windows utility that protects IME mode while selecting text with `Shift+Click`.

The foreground mode installs low-level keyboard and mouse hooks in the current user session. When a Shift key-up follows a Shift+left-click selection, the tool suppresses that key-up and posts/injects a replacement key-up so the target app does not toggle IME mode unexpectedly.

## Usage


Run in the current terminal:

```powershell
ime-shift-fix.exe
```

Install as a Windows service:

```powershell
ime-shift-fix.exe --install
```

Uninstall the service:

```powershell
ime-shift-fix.exe --uninstall
```

Show help:

```powershell
ime-shift-fix.exe --help
```

## Service Mode


The service does not install hooks inside Session 0. Instead, it starts the same executable in the active console user session with the internal `--user` option. That user-session process owns the hooks, so the behavior applies to the logged-in desktop.

`--install` and `--uninstall` first query whether the service already exists. They only request UAC elevation when a service state change is actually needed. The non-elevated parent waits for the elevated child process and then queries the service state again before printing the final result.

Internal options:

- `--service`: entry point used by the Windows Service Control Manager.
- `--user`: entry point used by the service to run hooks in the logged-in user session.

These are implementation details and are not needed for normal manual use.

## Build

### Prerequisites


For the `x86_64-pc-windows-msvc` target, build from an MSVC developer environment:

- Open "Developer PowerShell for VS 2022", or run `VsDevCmd.bat` or `vcvarsall.bat x64` before building.

### Building

```powershell
cargo build --release
```

The release binary is written to `target\release\ime-shift-fix.exe`.

## License


This project is licensed under either of the following, at your option:

- Apache License, Version 2.0
- MIT License