[Runtime Error] invalid keyboard layout passed.

[l4v3nx]

Already reported ? *

• I have searched the existing open and closed issues.

Regression?

Definitely a regression - something broke after update (requires bisect)

System Info and Hyprland Version

System/Version info

Hyprland 0.48.0 built from branch  at commit 5ee35f914f921e5696030698e74fb5566a804768  (version: bump to 0.48.0).
Date: Sun Mar 23 14:56:13 2025
Tag: v0.48.0, commits: 5922
built against:
 aquamarine 0.8.0
 hyprlang 0.6.0
 hyprutils 0.5.2
 hyprcursor 0.1.12
 hyprgraphics 0.1.2


no flags were set


System Information:
System name: Linux
Node name: hmb15-arch-pc2
Release: 6.13.8-arch1-1
Version: #1 SMP PREEMPT_DYNAMIC Sun, 23 Mar 2025 17:17:30 +0000


GPU information: 
03:00.0 VGA compatible controller [0300]: Advanced Micro Devices, Inc. [AMD/ATI] Lucienne [1002:164c] (rev c2) (prog-if 00 [VGA controller])


os-release: NAME="Arch Linux"
PRETTY_NAME="Arch Linux"
ID=arch
BUILD_ID=rolling
ANSI_COLOR="38;2;23;147;209"
HOME_URL="https://archlinux.org/"
DOCUMENTATION_URL="https://wiki.archlinux.org/"
SUPPORT_URL="https://bbs.archlinux.org/"
BUG_REPORT_URL="https://gitlab.archlinux.org/groups/archlinux/-/issues"
PRIVACY_POLICY_URL="https://terms.archlinux.org/docs/privacy-policy/"
LOGO=archlinux-logo


plugins:

Description

whenever i trigger loginctl lock-session to run hyprlock, i get a message in a red pill

[Runtime Error] invalid keyboard layout passed. (rules: , model: pc105, variant: = us, options: grp:alt_shift_toggle, layout: us,ru )

without being able to switch layout. after unlocking, if i run hyprctl reload, i get another error

Invalid keyboard layout passed. ( rules: , model: pc105, variant: us, options: grp:alt_shift_toggle, layout: us,ru ) 
Hyprland may not work correctly

it doesn't happen on sway with hyprlock as lock screen (so ig it's not hyprlock issue) and if i change any line in hyprland.conf, it temporarily fixes even after hyprctl reload
i don't seem to remember such issue when libxkbcommon package was <1.8.0.
so i explicitly downgraded this package and indeed, this problem doesn't appear on v1.7.0-2

my input section:

input {
    # Keyboard: Add a layout and uncomment kb_options for Win+Space switching shortcut
    kb_layout = us,ru
    kb_model = pc105
    kb_options = grp:alt_shift_toggle
    numlock_by_default = false
    repeat_delay = 250
    repeat_rate = 35
    sensitivity = 0.4  

    touchpad {
        natural_scroll = false
        disable_while_typing = true
        scroll_factor = 0.7
        middle_button_emulation = true
    }
    special_fallthrough = true
    follow_mouse = 1
}

my forked end-4 dots: https://github.com/l4v3nx/dots-hyprland

How to reproduce

1. run loginctl lock-session
2. get "[Runtime Error] invalid keyboard layout passed." error
3. run hyprctl reload
4. get "Invalid keyboard layout passed. (...) Hyprland may not work correctly " error

Attach not paste

• I understand that all text files must be attached, and not pasted directly. If not respected, this issue will likely get closed as spam

Checklist of files to include below

• Hyprland config - hyprctl systeminfo -c (always include)
• Crash report (always include in case of crash)
• Video (always include in case of a visual bug)
• Logs (might contain useful info such as errors)

Additional info & File uploads

recording_2025-03-28_23.33.42.mp4

hyprctl systeminfo -c > hypr-full-config.txt

hyprland.log

[l4v3nx]

same issue persists in 0.48.1-1

System/Version info

Hyprland 0.48.1 built from branch  at commit 29e2e59fdbab8ed2cc23a20e3c6043d5decb5cdc  (version: bump to v0.48.1).
Date: Fri Mar 28 16:16:07 2025
Tag: v0.48.1, commits: 5937
built against:
 aquamarine 0.8.0
 hyprlang 0.6.0
 hyprutils 0.5.2
 hyprcursor 0.1.12
 hyprgraphics 0.1.2


no flags were set


System Information:
System name: Linux
Node name: hmb15-arch-pc2
Release: 6.13.8-arch1-1
Version: #1 SMP PREEMPT_DYNAMIC Sun, 23 Mar 2025 17:17:30 +0000


GPU information: 
03:00.0 VGA compatible controller [0300]: Advanced Micro Devices, Inc. [AMD/ATI] Lucienne [1002:164c] (rev c2) (prog-if 00 [VGA controller])


os-release: NAME="Arch Linux"
PRETTY_NAME="Arch Linux"
ID=arch
BUILD_ID=rolling
ANSI_COLOR="38;2;23;147;209"
HOME_URL="https://archlinux.org/"
DOCUMENTATION_URL="https://wiki.archlinux.org/"
SUPPORT_URL="https://bbs.archlinux.org/"
BUG_REPORT_URL="https://gitlab.archlinux.org/groups/archlinux/-/issues"
PRIVACY_POLICY_URL="https://terms.archlinux.org/docs/privacy-policy/"
LOGO=archlinux-logo


plugins:

[vaxerski]

xkb handles your keyboard. If hyprland prints that it's invalid, it is invalid. Pass a valid keyboard layout configuration.

[fredrikv]

tl;dr: Run localectl list-x11-keymap-variants us to list available variants on your system (replace us with your layout of choice), or set kb_variant = to use the default variant (which worked for me).

I had the same error message under slightly different circumstances and was convinced it was a bug in Waland. But of course @vaxerski is correct! In my case, I had defined kb_variant = dvorak on the input level and (falsley) kb_variant = qwerty on the device level for a specific keyboard. Setting it to the default of an empty string solves the problem for me: kb_variant =

Regarding the error message mentioned in the issue:

[Runtime Error] invalid keyboard layout passed. (rules: , model: pc105, variant: = us, options: grp:alt_shift_toggle, layout: us,ru )

it says variant = us. At least on my system, us is not a valid valiant. I suspect variant = would fix the problem here as well. Run localectl list-x11-keymap-variants us to list available variants on your system (replace us with your layout of choice). I see:

alt-intl
altgr-intl
chr
colemak
colemak_dh
colemak_dh_iso
colemak_dh_ortho
colemak_dh_wide
colemak_dh_wide_iso
dvorak
dvorak-alt-intl
dvorak-classic
dvorak-intl
dvorak-l
dvorak-mac
dvorak-mac-iso
dvorak-r
dvp
euro
haw
hbs
intl
mac
mac-iso
norman
olpc2
rus
symbolic
workman
workman-intl