Skip to content

adds note about KeePassXC in common pitfalls #1344

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

audishos
Copy link

re. getting stuck in secure input mode, disabling option key binding

re. getting stuck in secure input mode, disabling `option` key binding
@@ -710,3 +710,5 @@ You can also use `on-window-detected` to force tile or force float all windows o
== Common pitfall: keyboard keys handling

If you can't make AeroSpace handle some keys in your config, please make sure that you don't have keys conflict with other software that might listen to global keys (e.g. skhd, Karabiner-Elements, Raycast)

If you have KeePassXC installed and up-to-date (v2.7.10 at the time of writing), you may notice that bindings which use the `option` key will stop working after some time. This is a known issue where KeePassXC gets stuck in secure input mode (see: https://github.com/keepassxreboot/keepassxc/issues/11906[#11906]). The recommendation for now is to downgrade to v2.7.9.
Copy link
Owner

@nikitabobko nikitabobko Apr 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's not only about KeePassXC. First and foremost, it's a macOS problem (aka "security feature") which is called "secure input" and the paragraph should be phrased this way. When any "security input" field is focused, global opt won't work (e.g. Terminal.app has it in its top menubar Terminal -> Secure Keyboard Entry)

The KeePassXC case is interesting because as it turns out it's possible to break macOS "secure input" in a way that even if the application runs only in background, it can also break global opt key

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants