Configuration Hotkeys and Blacklist

Hotkeys and blacklist

Two unrelated options that share a page because neither needs one of its own.

hotkeys

Global shortcuts, registered with the operating system. They work regardless of which layer is active and even where AnaNeo's own triggers do not reach.

"hotkeys": {
    "toggleActivation": "Shift+Pause",
    "toggleOSK": null,
    "toggleOneHandedMode": null
}

Hotkey	Function
toggleActivation	switch AnaNeo's keyboard hook on or off
toggleOSK	show or hide the on-screen keyboard
toggleOneHandedMode	switch one-handed mode on or off

null means no global hotkey is registered. Two of the three are null by default because they already have triggers – M3+F1 for the on-screen keyboard and M3+F10 for one-handed mode, both under locks. A global hotkey is only needed if you want the function while AnaNeo's own key handling is switched off, which is exactly the case for toggleActivation.

Syntax

Modifiers plus a main key: "Ctrl+Alt+F5", "Shift+Alt+Key_A", "Shift+Pause".

Allowed modifiers are Shift, Ctrl, Alt and Win. The main key is a virtual-key name without the VK_ prefix, from the VKEY enumeration in source/mapping.d, which follows the Win32 virtual-key codes.

These are not the same thing as lock triggers. A hotkey is registered with Windows and uses the native modifiers; a trigger is handled by AnaNeo itself and can use the Neo modifiers. If a hotkey is already taken by another program, registration fails silently and the shortcut does nothing.

blacklist

Programs for which AnaNeo should deactivate itself automatically. The window title is matched as a regular expression.

"blacklist": [
    { "windowTitle": "emacs" },
    { "windowTitle": "Virtual Machine Manager" }
]

Empty by default. Any window whose title contains a match switches AnaNeo off while it has focus; moving away switches it back on.

This is the usual answer to X servers, remote desktop clients, virtual machines and games – anything that either does its own keyboard handling or expects raw scan codes. When several nested systems are involved, the general rule is that the innermost system should carry the alternative layout and everything outside it should be plain QWERTZ/QWERTY.

Note that it matches a substring by default, since it is a regular expression and not anchored: "emacs" matches file.txt - emacs. Anchor it with ^ and $ if you need an exact title.