+1
Daily
15,379
stars
380
forks
51
watchers
860
prs
756
issues
43
releases
README
komorebi
Tiling Window Management for Windows.
!screenshot
Note: Students using devices enrolled in mobile device management (MDM)
Your usage still falls under the Komorebi License 2.0.0.
You can email me at the address I sign my commits with (add .patch to the end
of any commit URL on GitHub to find it) from the address associated with your
institution with the subject "komorebi - student with an MDM device", and I will
be able to remove the splash intended for corporate users, whose usage falls
under the Individual Commercial Use
License.
This is currently a manual process - most days this shouldn't take more than
12h, and you will receive an email reply from me when the process is complete.
If you haven't had a reply to your email within 24h you can reach out to me on
Discord.
Note: Unexpected mobile device management (MDM) detection prompts
You have most likely unintentionally enrolled your device in "Bring Your Own
Device" (BYOD) MDM. You can confirm if this is the case by running dsregcmd
/status and then take the appropriate steps to remove the MDM profile and take
back full control of your system.
If you need help doing this you can ask on Discord.
Note: komorebi for Mac
komorebi for Mac lives here :)
Overview
_komorebi_ is a tiling window manager that works as an extension to Microsoft's
Desktop Window
Manager in
Windows 10 and above.
_komorebi_ allows you to control application windows, virtual workspaces and display monitors with a CLI which can be
used with third-party software such as whkd
and AutoHotKey to set user-defined keyboard shortcuts.
_komorebi_ aims to make _as few modifications as possible_ to the operating
system and desktop environment by default. Users are free to make such
modifications in their own configuration files for _komorebi_, but these will
remain opt-in and off-by-default for the foreseeable future.
Please refer to the documentation for instructions on how
to install and
configure
_komorebi_, common workflows, a complete
configuration schema reference and a
complete CLI reference.
Community
There is a Discord server available for
_komorebi_-related discussion, help, troubleshooting etc. If you have any
specific feature requests or bugs to report, please create an issue in this
repository.
There is a YouTube
channel where I post
_komorebi_ development videos, feature previews and release overviews. Subscribing
to the channel (which is monetized as part of the YouTube Partner Program) and
watching videos is a really simple and passive way to contribute financially to
the development and maintenance of _komorebi_.
There is an Awesome List which
showcases the many awesome projects that exist in the _komorebi_ ecosystem.
Licensing for Personal Use
komorebi is educational source
software.
komorebi is licensed under the Komorebi 2.0.0
license, which is a fork of the
PolyForm Strict 1.0.0
license. On a high Top issues
#1543[BUG]: Komorebi Fails to Execute Commands on Time (delayed execution up to 10-15sec)13 comments · 2025-08-21#1454[BUG]: Fails to start if komorebi.json is a sym link12 comments · 2025-05-19#879[BUG]: Workspace switching loop11 comments · 2024-06-14#1446[FEAT]: Scratchpad10 comments · 2025-05-15#1637Error at installation ?9 comments · 2026-01-16#1636[BUG]: Window class "WinUIDesktopWin32WindowClass" freezes on first launch9 comments · 2026-01-14#1595[BUG]: Cmder will not enter into layout9 comments · 2025-11-07#1445[BUG]: Unexpected result after removing "grouping" from Bar config9 comments · 2025-05-15
Discussions
#1770Are apps restored from the system tray not managed by default?0 comments · 2026-11-14#1760Dynamically creating and moving workspaces1 comments · 2026-10-13#1745How do I allow task manager and other administrator apps to be tiled by Komorebi?1 comments · 2026-09-06#1731bug?1 comments · 2026-07-26#1720Light and Dark mode switching?0 comments · 2026-06-21#1702How to disable padding and border when only one window exist?0 comments · 2026-05-01#1695How to I get master stack layout like dwm/hyprpland in komorebi?2 comments · 2026-04-22#1694A graphical user interface or configuration file?0 comments · 2026-04-21
Latest release
v0.1.41 v0.1.41 2026-05-03v0.1.41 (2026-05-03) - Hind Rajab Would Have Been 8 Years Old Today Bug Fixes borders: prevent use-after-free take 4 (26b14643) wm: factor in monocle mode for work area offset rules (53c81c45) docs: add missing word (41fc316a) docs: update broken configuration schema link (96e87d8a) wm: correct layout rounding for uneven integer division (8889c3ca) wm: correct bsp/grid container positioning when flipped (634a3e7f) Code Refactoring clippy: apply lints (011bcb8b) Features wm: add global layout_defaults for per-layout default options (24c0ce0b) wm: add threshol