WSLGd: load keymap settings from .wslgconfig into weston.ini

[fargiolas]

Allow user to customize weston settings by providing a .weston.ini file in User Profile directory.

The idea is to give advanced users an easy way to configure a keymap to fallback to if weston rdp backend logic fails to find a mapping between current keyboard layout and XKB ones. See microsoft/weston-mirror#144 for further details.

[hideyukn88]

Hi. we don't want to expose weston.ini directly from Windows side, this is why we have exposed only certain configuration via .wslgconfig. If the configuration of default keyboard is necessary, please expose it via .wslgconfig, thanks!

[fargiolas]

@hideyukn88 see the new commit, it should address your concerns.

The idea is to add a new [weston-keyboard] (or whichever name you like) section in .wslgconfig where you can configure keymap settings that will be merged into wslg weston.ini when WSLGd starts and used as a fallback when keyboard layout mapping fails.

This way only keymap related settings are merged into weston.ini instead of exposing the full config file to the user.

This obviously depends on microsoft/weston-mirror#144 being merged as at the moment "us" layout is hardcoded in the rdp backend if layout mapping fails.

[fargiolas]

@hideyukn88 any feedback on the latest proposed changes? now that the other PR has been merged (thanks!) it would definitely make life easier for us custom layout users

[hideyukn88]

@fargiolas, currently we are evaluating the idea to have /etc/wslg.conf, similar to WSL's /etc/wsl.conf, inside user-distro filesystem, so we could do this utilizing that, so please hold on, thanks!

[fargiolas]

@fargiolas, currently we are evaluating the idea to have /etc/wslg.conf, similar to WSL's /etc/wsl.conf, inside user-distro filesystem, so we could do this utilizing that, so please hold on, thanks!

That would be great! Thanks for the update!

[cassiocsantana]

I'm looking forward to this update

[Ckln]

Same 👀

[benhillis]

Triage note (2026-05): Thanks for the patch and apologies for the long silence. This needs a rebase against main (GitHub is reporting merge conflicts) and a refresh against current WSLGd/main.cpp. Are you still interested in shepherding this through? If we don't hear back in 30 days I'll close it out and you (or anyone else) can reopen with a fresh branch.

The companion microsoft/weston-mirror#144 is also part of this work and would need to land first.

[fargiolas]

Hi @benhillis

I am still interested in solving this but I think it is waiting for a design decision from your side.

Currently it is possible to change weston keyboard layout injecting a custom weston.ini from wsl bash profile, something like:

wsl.exe --user root --system bash -c "grep -q keyboard
/home/wslg/.config/weston.ini" 2> /dev/null
weston_updated=$?

if [ "$weston_updated" -eq 1 ]; then
wsl.exe --user root --system bash -c "cat << EOF >>
/home/wslg/.config/weston.ini

[keyboard]
keymap_layout=us
keymap_variant=altgr-intl

EOF" 2> /dev/null
wsl.exe --user root --system pkill -HUP weston 2> /dev/null
fi

As long as this keeps working I am fine, I guess it's up to you to decide if you want to expose a saner way to configure wslg, weston or just the keyboard section.

The other PR (microsoft/weston-mirror#144), that makes the above workaround possible, is already merged since quite a while.