KORGWM(1)

📦 version 5.0, in alpine 3.24

✨ KORGWM(1) ✨

okay so bestie, this is a page from the User Contributed Perl Documentation section of the manual, and it's literally about korgwm 💅 (that's the name, that's the whole vibe, we move)

🎀 NAME 🎀

korgwm — a tiling window manager written in Perl. yes. in Perl. no cap. 🐪✨

🌸 DESCRIPTION 🌸

So it manages X11 windows in a tiling manner — like, it arranges your windows in tiles, no overlapping chaos — and it supports all the stuff KorG needs. that's the spec. that's the bar. 🫶

It's built on top of XCB, AnyEvent, and Gtk3. iconic stack, honestly.

Here's a detail that matters: it is not reparenting, and that's on purpose. so the borders are rendered by X11 itself, not by korgwm making a whole fake parent window situation. slay.

Also, there are no any command-line parameters, (almost) nor any environment variables. LIKE. barely any. so don't go looking for flags, girlies, there's nothing to find 🙈

The only way to start it is: just execute korgwm when no any other WM is running. that's it. that's the whole ritual.

korgwm

Please see the bundled README.md if you are interested in details — that's where the deeper lore lives 📖💜

⭐ CONFIGURATION ⭐

There are several things which affect korgwm behaviour. let's break it down:

Firstly, it has pretty good config defaults. like, out of the box it's already eating. 🔥

Then it reads several files during startup and merges the configuration.

⚠️ ok this is the important part: it merges configs pretty silly. so it is recommended to completely specify rules or hotkeys if you want to change their parts. don't come for half a rule, it will not work out the way you're picturing. fr fr.

The files are being read in such an order:

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

Please see the bundled korgwm.conf.sample to get the full listing of available configuration parameters — that's your master doc for every single knob you can turn 🎛️✨

🦋 INSTALLATION 🦋

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

perl Makefile.PL
make
make test
make install

like, that's it. go off. 👑

Although — it has a number of dependencies which in turn rely on C libraries. 😭 so to make the installation process smooth and nice you probably want to install them in advance. (key word: probably. it's the "future you will thank present you" move.)

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

get those in first and the build is giving main character energy instead of giving suffering 🌈💅

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

MIT License. Full text is in LICENSE — go read it if you're the type to read licenses (respect, honestly 🫶).

and that's the whole page, bestie!! no notes, ate and left no crumbs 💖

<span>perl v5.42.2 · 2026-02-15</span> — that's the version and date stamp, mwah, go tile some windows ✨🦋🎀

📦 where this page comes from