explaingit

lgug2z/komorebi

Analysis updated 2026-06-24

14,553RustAudience · developerComplexity · 4/5LicenseSetup · moderate

TLDR

Tiling window manager for Windows 10 and 11, written in Rust, controlled with a CLI and usually paired with a hotkey daemon like whkd or AutoHotKey.

Mindmap

mindmap
  root((komorebi))
    Inputs
      CLI commands
      Hotkey daemon
      Config files
    Outputs
      Tiled window layout
      Workspaces per monitor
      Status events
    Use Cases
      Power user workflow
      Keyboard driven Windows
      Multi monitor setup
    Tech Stack
      Rust
      Windows API
      whkd
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a keyboard driven tiling window manager on a Windows 10 or 11 desktop

USE CASE 2

Build a custom productivity workflow with hotkeys mapped to komorebi CLI commands

USE CASE 3

Set up multiple workspaces per monitor for development, chat, and browsing

USE CASE 4

Pair komorebi with whkd or AutoHotKey for fast window movement

What is it built with?

RustWindowswhkd

How does it compare?

lgug2z/komorebianalysis-tools-dev/static-analysisrust-embedded/rust-raspberrypi-os-tutorials
Stars14,55314,54214,654
LanguageRustRustRust
Last pushed2026-05-18
MaintenanceMaintained
Setup difficultymoderateeasyhard
Complexity4/51/55/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

You need to install a hotkey daemon and write your own config before the tiling becomes useful, and commercial users need a paid license.

Personal use is free under a fork of the PolyForm Strict license, but redistribution and any commercial use require a paid Individual Commercial Use License.

In plain English

Komorebi is a tiling window manager for Microsoft Windows 10 and Windows 11, written in Rust. A tiling window manager automatically arranges open application windows so they fit together without overlapping, instead of leaving you to drag and resize them by hand. Komorebi sits on top of Windows' built-in Desktop Window Manager rather than replacing it, so it changes how windows are laid out but tries to leave the rest of the operating system untouched. There is a separate sister project called komorebi for Mac for users on macOS. The project is controlled through a command line interface. You drive it by typing CLI commands that move, focus, or resize windows and switch between virtual workspaces on each monitor. Most people pair it with a hotkey daemon such as the author's own whkd, or with AutoHotKey, so that those CLI commands run when keyboard shortcuts are pressed. All configuration lives in user files, and the project keeps optional system tweaks off by default. Documentation is hosted on a dedicated site, with sections covering installation, example configurations, common workflows, a full schema reference, and a CLI reference. Installation can be done with the scoop or winget package managers, or by building from source. The README also links to a quickstart video and an Awesome Komorebi list of community projects built around it. Licensing is unusual. Komorebi is what the author calls educational source software, released under the Komorebi 2.0.0 license, which is a fork of the PolyForm Strict license. Personal use is allowed freely except for redistribution or hard-forks. Commercial use, including using komorebi at work, requires a paid Individual Commercial Use License sold through the author's website. There are special notes for students whose devices are enrolled in mobile device management. There is an active Discord server for support, a YouTube channel with development and feature videos, and GitHub Sponsors and Ko-fi pages. The author asks people to donate to the Palestine Children's Relief Fund or Gaza Funds before sponsoring him personally.

Copy-paste prompts

Prompt 1
Walk me through installing komorebi with scoop and wiring it up to whkd on Windows 11
Prompt 2
Write a starter komorebi config file with three workspaces and basic move and focus hotkeys
Prompt 3
Compare komorebi with i3 on Linux and Amethyst on macOS for keyboard driven tiling
Prompt 4
Help me decide whether my use of komorebi at work needs an Individual Commercial Use License

Frequently asked questions

What is komorebi?

Tiling window manager for Windows 10 and 11, written in Rust, controlled with a CLI and usually paired with a hotkey daemon like whkd or AutoHotKey.

What language is komorebi written in?

Mainly Rust. The stack also includes Rust, Windows, whkd.

What license does komorebi use?

Personal use is free under a fork of the PolyForm Strict license, but redistribution and any commercial use require a paid Individual Commercial Use License.

How hard is komorebi to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is komorebi for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.