feat(keepass): add settings UI and optimize sidebar mapping

Author: rederyk

docs/IPC.md

@@ -515,7 +515,7 @@ bind "Mod+P" { spawn "inir" "keepass" "toggle"; }
 bind "Mod+Ctrl+P" { spawn "inir" "keepass" "add"; }
 ```
 
-Requires `keepassxc` (for `keepassxc-cli`) and a `.kdbx` vault. Set `keepass.vaultDir` in the shell config to point at the directory containing your vaults (defaults to `~/.local/share/keepassqs`); existing vaults are listed in the picker, and new ones can be created from the UI.
+Requires `keepassxc` (for `keepassxc-cli`), `libsecret` (for `secret-tool`) and a `.kdbx` vault. Set `keepass.vaultDir` in the shell config to point at the directory containing your vaults (defaults to `~/.local/share/keepassqs`); existing vaults are listed in the picker, and new ones can be created from the UI. Password caching is handled securely via the system keyring.
 
 ---
 

docs/PACKAGES.md

@@ -197,6 +197,7 @@ Not installed by default, but useful. The shell handles their absence gracefully
 | Package | Purpose | Used by |
 |---------|---------|---------|
 | `keepassxc` | KeePass password manager (`keepassxc-cli`) | KeePass overlay panel |
+| `libsecret` | Secret Service CLI (`secret-tool`) | KeePass password caching |
 | `warp-cli` | Cloudflare WARP VPN toggle | Quick toggles panel |
 | `ollama` | Local LLM for AI chat | Sidebar AI assistant |
 | `cava` | Audio visualizer | Bar widget (optional) |

modules/settings/ServicesConfig.qml

@@ -1404,4 +1404,30 @@ ContentPage {
         }
     }
 
+    SettingsCardSection {
+        expanded: false
+        icon: "key"
+        title: Translation.tr("KeePass")
+
+        SettingsGroup {
+            StyledText {
+                Layout.fillWidth: true
+                text: Translation.tr("Integrate with KeePassXC-CLI to manage passwords directly from the shell.")
+                color: Appearance.colors.colOnSurfaceVariant
+                font.pixelSize: Appearance.font.pixelSize.small
+                wrapMode: Text.WordWrap
+            }
+
+            MaterialTextArea {
+                Layout.fillWidth: true
+                placeholderText: Translation.tr("Vault directory (where your .kdbx files are)")
+                text: Config.options?.keepass?.vaultDir ?? ""
+                wrapMode: TextEdit.Wrap
+                onTextChanged: Config.setNestedValue("keepass.vaultDir", text)
+                StyledToolTip {
+                    text: Translation.tr("The directory containing your KeePass databases. If empty, the shell will look in common locations.")
+                }
+            }
+        }
+    }
 }

modules/sidebarRight/SidebarRight.qml

@@ -22,35 +22,20 @@ Scope {
         id: sidebarRoot
 
         Component.onCompleted: {
-            visible = GlobalStates.sidebarRightOpen
             root._sidebarShown = GlobalStates.sidebarRightOpen
         }
 
         Connections {
             target: GlobalStates
             function onSidebarRightOpenChanged() {
                 if (GlobalStates.sidebarRightOpen) {
-                    _closeTimer.stop()
-                    sidebarRoot.visible = true
-                    // Let the surface map for one frame before sliding in
                     Qt.callLater(() => { root._sidebarShown = true })
-                } else if (root.instantOpen || !Appearance.animationsEnabled) {
-                    root._sidebarShown = false
-                    _closeTimer.stop()
-                    sidebarRoot.visible = false
                 } else {
                     root._sidebarShown = false
-                    _closeTimer.restart()
                 }
             }
         }
 
-        Timer {
-            id: _closeTimer
-            interval: 300
-            onTriggered: sidebarRoot.visible = false
-        }
-
         function hide() {
             GlobalStates.sidebarRightOpen = false
         }
@@ -60,6 +45,10 @@ Scope {
         WlrLayershell.namespace: "quickshell:sidebarRight"
         WlrLayershell.keyboardFocus: GlobalStates.sidebarRightOpen ? WlrKeyboardFocus.Exclusive : WlrKeyboardFocus.None
         color: "transparent"
+        // Keep the surface always mapped to avoid Qt6 physicalDpiChanged infinite
+        // recursion (stack overflow) triggered by Hyprland sending a Wayland scale
+        // event on remap. Input is controlled via mask instead of visibility.
+        mask: Region { item: GlobalStates.sidebarRightOpen ? backdropClickArea : noInputItem }
 
         anchors {
             top: true
@@ -68,10 +57,12 @@ Scope {
             left: true
         }
 
+        Item { id: noInputItem; width: 0; height: 0 }
+
         CompositorFocusGrab {
             id: grab
             windows: [ sidebarRoot ]
-            active: CompositorService.isHyprland && sidebarRoot.visible
+            active: CompositorService.isHyprland && GlobalStates.sidebarRightOpen
             onCleared: () => {
                 if (!active) sidebarRoot.hide()
             }

services/KeePass.qml

@@ -12,7 +12,7 @@ import Quickshell.Io
 Singleton {
     id: root
 
-    property string scriptPath: FileUtils.trimFileProtocol(`${Directories.config}/quickshell/inir/scripts/quickshell-keepass`)
+    property string scriptPath: FileUtils.trimFileProtocol(`${Directories.scriptsPath}/quickshell-keepass`)
     readonly property string vaultDir: Config.options?.keepass?.vaultDir
         || FileUtils.trimFileProtocol(`${Directories.home}/.local/share/keepassqs`)
     property string vaultPath: ""