90 lines
2.9 KiB
Python
90 lines
2.9 KiB
Python
"""Remove a PowerToys Keyboard Manager global shortcut by key combination."""
|
|
|
|
import json
|
|
import os
|
|
|
|
# Windows Virtual Key codes — key name (lowercase) → VK int
|
|
VK_CODES: dict[str, int] = {
|
|
"lwin": 91, "rwin": 92,
|
|
"lshift": 160, "rshift": 161, "shift": 160,
|
|
"lctrl": 162, "rctrl": 163, "ctrl": 162,
|
|
"lalt": 164, "ralt": 165, "alt": 164,
|
|
"space": 32, "enter": 13, "tab": 9, "esc": 27,
|
|
"win": 91,
|
|
# F-keys
|
|
"f1": 112, "f2": 113, "f3": 114, "f4": 115,
|
|
"f5": 116, "f6": 117, "f7": 118, "f8": 119,
|
|
"f9": 120, "f10": 121, "f11": 122, "f12": 123,
|
|
# Digits
|
|
"0": 48, "1": 49, "2": 50, "3": 51, "4": 52,
|
|
"5": 53, "6": 54, "7": 55, "8": 56, "9": 57,
|
|
}
|
|
# Letters A-Z
|
|
for _ch in "abcdefghijklmnopqrstuvwxyz":
|
|
VK_CODES[_ch] = ord(_ch.upper())
|
|
|
|
|
|
def _keys_to_vk_string(keys: list[str]) -> str:
|
|
"""Convert a list of key names to a semicolon-separated VK code string."""
|
|
codes = []
|
|
for key in keys:
|
|
normalized = key.lower()
|
|
if normalized not in VK_CODES:
|
|
raise ValueError(
|
|
f"Unknown key name: '{key}'. "
|
|
f"Use names like 'ctrl', 'alt', 'lctrl', 'lalt', 'shift', 't', 'f1', etc."
|
|
)
|
|
codes.append(str(VK_CODES[normalized]))
|
|
return ";".join(codes)
|
|
|
|
|
|
def _default_config_path() -> str:
|
|
override = os.environ.get("POWERTOYS_CONFIG")
|
|
if override:
|
|
return override
|
|
user = os.environ.get("USER") or os.environ.get("USERNAME", "")
|
|
return (
|
|
f"/mnt/c/Users/{user}/AppData/Local/Microsoft/PowerToys"
|
|
f"/Keyboard Manager/default.json"
|
|
)
|
|
|
|
|
|
def powertoys_shortcut_remove(
|
|
keys: list[str],
|
|
config_path: str | None = None,
|
|
) -> bool:
|
|
"""Remove a global shortcut from PowerToys Keyboard Manager config by key combination.
|
|
|
|
Converts the key list to a VK code string and removes the matching entry from
|
|
remapShortcuts.global. Writes back in compact JSON format.
|
|
|
|
Args:
|
|
keys: List of key names (case-insensitive) identifying the shortcut to remove.
|
|
Must match exactly the keys used when the shortcut was created.
|
|
config_path: Path to default.json. If None, uses $POWERTOYS_CONFIG or WSL default.
|
|
|
|
Returns:
|
|
True if a shortcut was found and removed, False if no matching shortcut existed.
|
|
"""
|
|
if config_path is None:
|
|
config_path = _default_config_path()
|
|
|
|
with open(config_path, "r", encoding="utf-8") as f:
|
|
data = json.load(f)
|
|
|
|
original_keys_str = _keys_to_vk_string(keys)
|
|
|
|
global_list: list[dict] = data.get("remapShortcuts", {}).get("global", [])
|
|
original_len = len(global_list)
|
|
filtered = [e for e in global_list if e.get("originalKeys") != original_keys_str]
|
|
|
|
if len(filtered) == original_len:
|
|
return False
|
|
|
|
data["remapShortcuts"]["global"] = filtered
|
|
|
|
with open(config_path, "w", encoding="utf-8") as f:
|
|
json.dump(data, f, separators=(",", ":"), ensure_ascii=False)
|
|
|
|
return True
|