Jeezy LGUG2Z

Full desktop shell in WSL2 using WSLg (XWayland)

Note

If you want to use Wayland in WSLg in a simpler setup, you can try the WSLg (Wayland) tutorial.

In this tutorial, we will setup GUI in WSL2. No additional software outside WSL (like VcXsrv or GWSL) is required. You will find this tutorial very similar to the one that replaces Xorg with Xvnc. Indeed, it's pretty much the same tutorial, with some few changes.

The key component we need to install is the desktop metapackage you want (GNOME, KDE, Xfce, Budgie, etc), and after that, replace the default Xorg by a script that calls Xwayland instead.

For this setup, I will use Ubuntu 24.04, and install GNOME Desktop. Unfortunately older versions of Ubuntu lack some fundamental things, so we cannot reproduce it in older versions (at least not fully). Since the key components aren't bound to Ubuntu or GNOME, you can use your favorite distro and GUI. Check the [Sample screenshot

	{
	"$schema": "http://json-schema.org/draft-07/schema#",
	"title": "KomobarConfig",
	"description": "The `komorebi.bar.json` configuration file reference for `v0.1.38`",
	"type": "object",
	"required": [
	"left_widgets",
	"monitor",
	"right_widgets"

	{
	"$schema": "https://raw.githubusercontent.com/LGUG2Z/komorebi/refs/heads/master/schema.json",
	"app_specific_configuration_path": "$Env:KOMOREBI_CONFIG_HOME/applications.json", // MAKE SURE YOU DON'T COPY THIS PART BLINDLY
	"window_hiding_behaviour": "Cloak",
	"cross_monitor_move_behaviour": "Insert",
	"cross_boundary_behaviour": "Monitor",
	"default_workspace_padding": 14,
	"default_container_padding": 14,
	"resize_delta": 200,
	"floating_window_aspect_ratio": "Widescreen",

	{
	"$schema": "http://json-schema.org/draft-07/schema#",
	"title": "StaticConfig",
	"description": "The `komorebi.json` static configuration file reference for `v0.1.37`",
	"type": "object",
	"properties": {
	"animation": {
	"description": "Animations configuration options",
	"type": "object",
	"required": [

	;; file name should be minimal.kbd
	;; the .clj ext in the gist is only used to get lisp syntax highlighting

	(defcfg)

	(defsrc
	;; mods
	esc tab caps lsft lctl lalt lmet spc rsft
	;; numbers
	1 2 3 4 5 6 7 8 9 0

	{
	"$schema": "http://json-schema.org/draft-07/schema#",
	"title": "StaticConfig",
	"description": "The `komorebi.json` static configuration file reference for `v0.1.36`",
	"type": "object",
	"properties": {
	"animation": {
	"description": "Animations configuration options",
	"type": "object",
	"required": [

	# mousemaster will automatically convert the key aliases to your current keyboard layout.
	# However, if you want to make a change to the key aliases, and your keyboard layout
	# is not us-qwerty, then remove .us-qwerty
	key-alias.enablebasekey.us-qwerty=e capslock
	key-alias.exit.us-qwerty=q p capslock
	key-alias.clickthendisable.us-qwerty=.
	key-alias.up.us-qwerty=i
	key-alias.down.us-qwerty=k
	key-alias.left.us-qwerty=j
	key-alias.right.us-qwerty=l