keymapper: matoleo yote na matoleo ya zamani

Added
- Added the @icon directive for setting custom active and inactive tray icons.
- Dimmed the tray icon when keymapper is inactive.
- Added keymapperctl --focused "window" for injecting window focus changes.

Fixed
- Updated the GNOME Shell extension to connect signals only while it is enabled.
- Fixed Windows installer task registration by resolving [UserSID] to an account name (#324).

Fixed
- Fixed timeouts in output expressions (#390).

Fixed
- Fixed latency of keymapperctl actions on Linux (#383).

Added
- Allowed to run alongside Karabiner-Elements (#376).
- Allowed timeouts after key release in input expression. e.g.:
# Turn A to C when B quickly follows release of A
!A !250ms B >> Backspace C

Changed
- Updated Karabiner-DriverKit-VirtualHIDDevice to version v8.2.0 (#384, #389).
- Disallowed opening modifier groups twice, as this has no effect. e.g. A{{B}}.

Fixed
- Improved mouse hooking efficiency on Windows (#383, #184).
- Improved process spawning efficiency on Windows (#383).
- Prevented handle leaking into child processes spawned by $(...) on Linux, which caused "Binding control port failed" errors after restart (#388).

Added
- Allow timeouts in input expressions which never partially match / start with ? (#372). e.g.
# Turn A to C when B quickly follows A
? A !250ms B >> Backspace C

Fixed
- Allow held key to match different mappings even when timeouts are used (#372). e.g.
# Keep outputting C and D alternately while A is held
state = Virtual
!state A{250ms} >> C state
state A{250ms} >> D !state
# reset state to always start with C
!A >> !state
- Synchronizing active state with tray menu entry on Linux (#370).

Fixed
- Made xwayland detection more robust (#368).
- Fixed reconnection of keymapper after keymapperd restart on Linux.
- Fixed hiding of tray icon on Linux.
- Hiding tray icon on Windows when disconnected.
- Replaced dummy icon on MacOS.
- No longer automatically restarting agent/deamon on MacOS.

Added
- Added mouse support to MacOS version. Touchpads and their buttons are still not supported (#228).
- Added keymapperctl --type-stdin for piping in strings. e.g.:
echo "Test" | keymapperctl --type-stdin

Changed
- Increased limit of actions from 256 to 1024 (#356).
- Increased limit of automatically assigned virtual keys from 256 to 1024.
- Checking whether keymapper control port could be bound on Linux.

Fixed
- Show error when action limit is exceeded.
- Detect switching to empty workspace in wlroots (#362).
- Omitting initial verbose logging of "Detected focused window changed".

Fixed
- Fixed keymapperctl --wait setting a timeout (#355).

Changed
- On Windows the mouse is now also only hooked when it has mappings. One can add @grab-device mouse to further hook it unconditionally (#344).
- On Windows the devices are unhooked when the active context only contains Any >> Any (#351).
- keymapper-launchd also installs the Karabiner-DriverKit-VirtualHIDDevice daemon (#298).
- Updated Karabiner-DriverKit-VirtualHIDDevice to version 6.10.0.

Fixed
- Fixed expression Any to match all inputs (#351).
- Fixed string comparison blocks with empty strings (#334).

### Added

- Added FreeBSD support (#222).
- Allow keymapperctl to press/release non-virtual keys (#348).
- Added getenv builtin macro and string comparison blocks (#334). .e.g.:
```ini
# activate context when environment variable has some specific value
[getenv["HOSTNAME"] = "LaptopMum"]
```
- Added window title change detection to KWin script (#349).
- Improved version mismatch error dialog on Windows.

Changed
- Showing path in "Opening configuration file failed" error (#326).

Fixed
- Fixed concurrent output on release (#341).
- Fixed empty strings in context filters (#329).
- Added missing dependency to DEB package.
- Bundling documentation (#336).

Fixed
- Fixed ContextActive for contexts with device filter (#319).
- Fixed keymapperctl --next-key-info (#314).
- Fixed disabling notifications (#314).

Added
- Added keymapperctl --print "string" (#312).
- Allow to pass key Any to keymapperctl --wait-toggled (#312).

Fixed
- Retry initializing Winsock when network subsystem is not ready yet (#313).
- Fixed path separator in keymapper-launchd (#298).

Added
- Added directive @virtual-keys-toggle, which allows to change the behavior of virtual keys in outputs (#309). e.g.
@virtual-keys-toggle true # true is (still) the default
# toggle Virtual1
F1 >> Virtual1
@virtual-keys-toggle false
# press Virtual1
F1 >> Virtual1
# release Virtual1
F2 >> !Virtual1
# toggle Virtual1
Virtual1{F3} >> !Virtual1
F3 >> Virtual1

Fixed
- Improved performance of sending mouse events on Windows (#300).
- Fixed output on release with together groups (#306).

Added
- Verbose keymapper logging logs virtual key state changes (#297).
- Allowing next-key-info to report multiple keys (#212).

Fixed
- Fixed obtaining current keyboard layout on X11/XKB (#296).
- Ignoring key repeat also when mouse was clicked (#294).
- Fixed keymapperctl --toggle when invalid key is passed.

The reason for the major version number increment is mainly because of the changed behavior of ;. Up until 4.9 it was documented to start comments like #. Otherwise all configurations should work like before.
Added
- Allow to separate multiple mappings on one line with ;. This is useful for macros which generate multiple mappings. e.g.:
swap = $0 >> $1 ; $1 >> $0
swap[Y, Z]
- Allow to add mappings for inputs which are released. e.g.:
# trigger when A is released
!A >> B
# trigger when B is released while A is held
A{!B} >> C
# trigger when B is released while A is NOT held
!A !B >> C
- Toggling virtual keys can also have immediate effects. Using them as modifiers is toggling them twice:
# toggle Virtual1 before and after pressing B
# this effectively maps D to A B C
Virtual1 >> A ^ C
D >> Virtual1{B}
# {} may also be empty. This maps C to A B
Virtual2 >> B
Virtual1 >> A Virtual2{}
C >> Virtual1{}
- Automatically replace Virtual with an unused virtual key. e.g.:
# assign different virtual keys to VimMode and CapsWord
VimMode = Virtual
CapsWord = Virtual
- Added keymapperctl operation --notify for showing notifications (#282). e.g.:
notify = $(keymapperctl --notify "$0")
F1 >> notify["Test"]
- Added toggle-active directive, which allows to set a sequence that de-/activates keymapper (#283). e.g.:
@toggle-active ScrollLock
- Added include-optional directive, which includes a file but does not fail when file does not exist.

Fixed
- Fixed suppressed modifiers getting reapplied (#291).
- Fixed loading config from "%HOME%\.config\keymapper" on Windows (#292).
- Properly releasing keys when UAC prompt appeared on Windows.

Fixed
- Fixed problem with virtual keys (introduced in 4.12.1 for #275).
- Fixed checking for a specific number of mouse wheel events (#280).

Added
- Showing a hint in "Next Key Info" that Gnome/KDE script is not enabled.

Changed
- Handling only lowres wheel events by default on Linux (#268).

Fixed
- Not blocking when opening configuration from tray on Linux (#220).
- Fixed focus update when xwayland app is minimized to tray (#220).
- Fixed device context fallthrough (#277).
- Optimized SVG icon.

Changed
- First try to find a match also including already matched events (#275).

Fixed
- Made automatically reloading configuration file more robust (#276).

Added
- Added dead key support to string typing on MacOS.
- Added dependencies of other Linux systems to build instructions.

Changed
- Single character literals only set state of shift modifier, to make shortcuts like Ctrl-< work, when mapping to '<'.
- First try to match last matching mapping again (#275).

Fixed
- Fixed some problems with FN key on MacOS (#263).
- Fixed unexpected input matching (#267).
- Allowing string literals in more places (#260 and #261).
- Ensure virtual device name is completely appended to forward devices on Linux.

Fixed
- Fixed character typing on X11 systems with xkbcommon versions < 1.0 (#258)

Added
- Added general unicode character typing on Windows (#240).

Fixed
- Fixed some problems with FN key on MacOS (#239, #249).
- Added installation path in keymapper's PATH variable on MacOS (#251).
- Added redundancy check to wlroots context update.

Changed
- Unconditionally grabbing mouse on Windows again (#236).

Fixed
- Sending mouse events with virtual device which forwards movement on Linux (#188).
- Sending less low-resolution mouse wheel events on Linux.
- Fixed mouse button-repeat prevention on Windows (#236).

Added
- Providing arm64 binaries for Linux and Windows and universal binaries for MacOS.

Changed
- Grabbing mouse only when it has mappings on Windows (#236).
- Parsing macros in inactive systems' contexts.

Fixed
- Fixed keyrepeat after timeout (#216).
- Ignoring surplus timeout events in sequence (#113 and #217).
- Fixed low-resolution-only wheels on Linux (#232).
- Fixed missing help output (#233).
- Fixed build on Raspberry Pi (#224).

Added
- Added @done directive to stop parsing configuration.

Fixed
- Fixed immediately releasing (e.g. A >> B !B).
- !Any checks previously matched (e.g. A{Any !Any} >> Meta{Any}) (#187).
- Improved swapping mouse wheel directions (delta of input is used) (#184).
- Fixed Next key info when key name is unknown.
- Next key info also shows wheel events.

Added
- Added string interpolation, which works in strings, terminal commands and regular expressions. e.g.:
VAR = "World"
A >> "Hello ${VAR}" # $VAR also works
- Allow to split a line with a \ at the end. e.g.:
Shift{A} >> \
Control{B}

Changed
- Aliases are no longer automatically substituted in terminal commands (use string interpolation).

Fixed
- Fixed too eager macro evaluation.

Fixed
- Prevent key state validation from resetting virtual key state on Windows.

Fixed
- Fixed device filter on MacOS.
- Fixed forwarding of FN keys on MacOS.
- Fixed slowly appearing tray icon menu on Linux.

Added
- Added "Devices" entry to tray icon menu.
Changed
- Always using Interception when available on Windows.
Fixed
- Fixed tray icon Linux.

Added
- Added keymapper tray icon for Linux (#126).
Fixed
- Further improved selection of key releasing a triggered output (#122).
- Fixed logical keys in context modifiers (#128).
- Fixed ContextActive with fallthrough contexts.

Fixed
- Improved selection of key releasing a triggered output (#122).
- Improved forwarding of input when a potential match fails.

Fixed
- Fixed input timeouts on Linux (#91).
- Fixed ContextActive with output on release (#91).
- Restored substition of aliases in terminal commands (#91).
- Fixed error notifications on Linux.

Added
- Added virtual key ContextActive (#91).
- Added aliases with parameters (#91).
- Added keymapperctl application (#105).
- Added device filter support on Windows using Interception (#107).
- Allow to invert context filters with !=.
- Added fallthrough of empty context blocks.
Changed
- Ignore aliases defined in contexts of other systems.
- Completely resetting state of virtual keys when updating the configuration.
- Setting keymapper process priority to high on Windows
- Exiting when config is invalid and not reloaded on Windows (#114).
- Allow to separate context filters with comma.
Fixed
- Fixed groups with not timeout.
- Not grabbing gamedevices on Linux.
- Fixed starting multiple terminal commands at once.
- Fixed dependencies of the RPM package.

Fixed
- Fixed device filters when devices are changing also for MacOS.

Fixed
- Fixed device filters when devices are changing (#41).
- Fixed process starting on Windows (#102).
- Interpreting escape sequence only in character typing string literals (\n, \r, \t).

Added
- Added keys Again, Props, Undo, Select, Copy, Open, Paste, Find, Cut, Help, Sleep,
Changed
- Applying context updates even when a key is hold (#99).
Fixed
- Improved keymapperd shutdown signal handing (#101)
- Hold Virtual keys could prevent context updates (#41, #99).

Added
- Added diacritic support to string typing on Windows.
- Allow context filters to contain aliases.
Changed
- Improved bringing spawned applications to front on Windows.
Fixed
- Prevent second keymapper process from partially connecting on Linux.
- Prevent alias substitution in strings.

Added
- _Not_-key following key in input expression matches when key is released. e.g.
Space{A !
A} >> Control{A}
Changed
- No longer implicitly waiting for key release before timeout. e.g.
A !250ms B. Previously the timeout started when A was released, now it starts when it is pressed.
A !A !100ms B is needed to get the old behaviour.
- Prevent input sequences without key down. e.g. !
A 500ms