X11::korgwm(3)

📦 version 5.0, in alpine 3.24

okay bestie, welcome to X11::korgwm(3) — yes, that's the manual name — and it's coming at you from the User Contributed Perl Documentation corner 💖✨

🌸 NAME 🌸

korgwm — a tiling window manager written in Perl. periodt. 💅

🦋 DESCRIPTION 🦋

okay so korgwm manages X11 windows in a tiling manner and supports all the stuff KorG needs. no cap. It's built on top of XCB, AnyEvent, and Gtk3. It is not reparenting for purpose, so borders are rendered by X11 itself. iconic behavior honestly.

There are no any command-line parameters, (almost) nor any environment variables. So the only way to start it is: just execute korgwm when no any other WM is running. that's the whole vibe check. Please see bundled README.md if you are interested in details 🫶

🎀 CONFIGURATION 🎀

there are several things which affect korgwm behaviour. Firstly, it has pretty good config defaults — slay. Then it reads several files during startup and merges the configuration. Note that it merges configs pretty silly. So it is recommended to completely specify rules or hotkeys if you want to change their parts. fr fr, don't leave bits half-said.

The files are being read in such an order:

  1. /etc/korgwm/korgwm.conf
  2. /usr/local/etc/korgwm/korgwm.conf
  3. $HOME/.korgwmrc
  4. $HOME/.config/korgwm/korgwm.conf

Please see bundled korgwm.conf.sample to get the full listing of available configuration parameters. iykyk 🌈

🛠️ INSTALLATION 🛠️

as it is written entirely in pure Perl, the installation is pretty straightforward:

perl Makefile.PL
make
make test
make install

Although it has number of dependencies which in turn rely on C libraries. To make the installation process smooth and nice you probably want to install them in advance. For Debian GNU/Linux these should be sufficient:

build-essential libcairo-dev libgirepository1.0-dev libglib2.0-dev xcb-proto

And these for Archlinux:

base-devel cairo glib2 gobject-introspection gtk3 libgirepository xcb-proto

Copyright (c) 2023--2025 Sergei Zhmylev <zhmylove@narod.ru<gt>

MIT License. Full text is in LICENSE.

This page is running perl v5.42.2, dated 2026-02-15, and it's literally X11::korgwm(3). bye bestie, go tile some windows 💖🦋✨

📦 where this page comes from