Hyprland 项目中的大写锁定状态显示功能实现

在 Linux 桌面环境 Hyprland 中，用户提出了一个关于在锁屏界面显示大写锁定状态的实用功能需求。本文将详细介绍该功能的实现原理和技术方案。

功能背景

许多键盘设备缺乏大写锁定状态的视觉指示器，特别是在锁屏界面下，用户无法直观地判断当前是否启用了大写锁定。这可能导致用户在输入密码时因大小写状态不明而出现输入错误。

技术实现方案

方案一：利用 Hyprland 内置功能

Hyprland 实际上已经内置了部分大写锁定提示功能 - 当大写锁定启用时，锁屏界面的输入框会变为红色。但这种提示方式不够直观明确。

方案二：通过 hyprctl 命令检测状态

更明确的解决方案是通过 hyprctl devices 命令获取键盘状态信息。具体实现步骤如下：

1. 识别主键盘设备：Hyprland 会标记主键盘为 main: yes
2. 提取大写锁定状态：从设备信息中解析 capsLock 字段

实现脚本示例：

#!/bin/bash
MAIN_KB_CAPS=$(hyprctl devices | grep -B 6 "main: yes" | grep "capsLock" | head -1 | awk '{print $2}')

if [ "$MAIN_KB_CAPS" = "yes" ]; then
    echo "CAPS LOCK ON"
else
    echo ""
fi

方案三：使用 Unicode 图标提示

为了更美观的显示，可以使用 Unicode 字符替代文字提示，如使用上箭头符号 ↑ 表示大写锁定状态。

技术原理

Hyprland 底层通过 xkb_state_mod_name_is_active 函数检测修饰键状态。这个函数与 XKB 键盘映射系统交互，独立于物理键盘的 LED 指示灯，因此可靠性更高。

配置方法

在 Hyprlock 配置文件中添加以下内容即可实现大写锁定状态提示：

label {
    monitor =
    text = cmd[update:250] ${XDG_CONFIG_HOME:-$HOME/.config}/hypr/hyprlock/check_capslock.sh
    color = rgba(FF5050FF)
    font_size = 16
    position = 0, -20
    halign = center
    valign = center
}

总结

通过简单的脚本和配置，我们可以在 Hyprland 锁屏界面实现清晰的大写锁定状态提示。这个方案不依赖物理键盘指示灯，具有更好的兼容性和可靠性。用户可以根据个人喜好选择文字提示或图标提示，提升使用体验。