fn_registry/python/functions/infra/powertoys_shortcut_add.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path, notes

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path	notes
powertoys_shortcut_add	function	py	infra	1.0.0	impure	def powertoys_shortcut_add(keys: list[str], target_path: str, args: str = "", elevated: bool = False, exact_match: bool = False, start_in_dir: str = "", config_path: str | None = None) -> None	Añade o reemplaza un atajo global en el config de PowerToys Keyboard Manager. Convierte nombres legibles de teclas a VK codes y escribe JSON compacto (una linea) para mantener compatibilidad con el formato de PowerToys.	powertoys keyboard windows wsl shortcut config write add pendiente-usar				false	error_py_core	json os	name desc keys Lista de nombres de teclas (case-insensitive). Ej: ['lctrl', 'lalt', 't']. Modificadores: lctrl/rctrl/ctrl, lalt/ralt/alt, lshift/rshift/shift, lwin/rwin/win. Letras: a-z. Digitos: 0-9. F-keys: f1-f12. Especiales: space, enter, tab, esc. name desc target_path Path Windows al ejecutable. Ej: 'C:\Windows\System32\wt.exe'. name desc args Argumentos de linea de comandos para el programa (default vacio). name desc elevated Si True, lanza el programa elevado (runProgramElevationLevel=1). Default False. name desc exact_match Si True, el atajo requiere coincidencia exacta de teclas. Default False. name desc start_in_dir Directorio de trabajo para el programa. Default string vacio. name desc config_path Path al default.json. Si None, usa $POWERTOYS_CONFIG o el path WSL por defecto para $USER.	None. Modifica el archivo default.json en disco.	false			python/functions/infra/powertoys_shortcut_add.py	error_py_core no existe en el registry. Esta funcion lanza excepciones nativas de Python: FileNotFoundError si config_path no existe, json.JSONDecodeError si el JSON es invalido, ValueError si un nombre de tecla no esta en VK_CODES. El JSON se escribe en formato compacto (separators=(",", ":")) — sin espacios ni saltos de linea — para mantener compatibilidad con el formato que usa PowerToys en el archivo original. El dict VK_CODES mapea "ctrl"->162, "alt"->164, "shift"->160, "win"->91 como aliases a las variantes izquierdas. Para especificar side derecho, usar "rctrl", "ralt", etc. Si ya existe una entrada con los mismos originalKeys, la reemplaza en su posicion original.

Ejemplo

from infra.powertoys_shortcut_add import powertoys_shortcut_add

# Anadir Ctrl+Alt+T -> Windows Terminal
powertoys_shortcut_add(
    keys=["lctrl", "lalt", "t"],
    target_path=r"C:\Windows\System32\wt.exe",
    start_in_dir=r"C:\Users\lucas",
)

# Anadir Win+Shift+E -> Explorer elevado
powertoys_shortcut_add(
    keys=["win", "shift", "e"],
    target_path=r"C:\Windows\explorer.exe",
    elevated=True,
)

Notas

Despues de modificar el config, PowerToys necesita reiniciarse para detectar los cambios. Usar powertoys_restart_py_infra para recargar la configuracion automaticamente.