input(macOS): preserve Caps Lock key releases - #7840
Merged
Conversation
lprazdnik
force-pushed
the
fix/caps-lock-release
branch
from
August 31, 2026 00:36
e8c462d to
d8d9704
Compare
macOS treats Caps Lock as a locking modifier and never delivers its physical release, so once "Caps Lock is treated as a key" is enabled a guest that uses it as a held modifier (e.g. a screen reader's NVDA key) never sees it let go. While VM input is captured, remap Caps Lock to F20 on each attached keyboard through IOHIDEventSystemClient (Apple TN2450) so macOS delivers a normal key down/up pair, which VMMetalView translates back to the Caps Lock scan code. The keyboard's previous mapping is put back when capture ends, and a remap left behind by a crash is removed at the next launch. F20 is the highest function key macOS delivers and is on no Apple keyboard, so no physical key is shadowed. Fixes utmapp#7838 Assisted-by: Codex:gpt-5 Assisted-by: Claude:claude-fable-5-1
osy
force-pushed
the
fix/caps-lock-release
branch
from
September 1, 2026 22:00
d8d9704 to
8f7a663
Compare
Contributor
|
@lprazdnik I've re-written the commit, can you re-test? |
Contributor
Author
|
I tested the latest commit with Windows 11 ARM and NVDA. Caps Lock works as expected, including repeated commands while held and normal input after release. Thanks! |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Resolves #7838
Testing
Tested by a human on a MacBook Pro with Apple M5 Max running macOS 26.6.2, using Windows 11 ARM as a QEMU guest with NVDA.
Verified repeated commands while Caps Lock remained held, normal input after releasing Caps Lock, and restoration of the host keyboard mapping after releasing VM input.
The author acknowledges that this change has been tested and/or reviewed by a human in accordance with UTM's AI contribution guidelines.