LazyWM Documentation
LazyWM
Project
GitHub ↗
Releases ↗
Supporting Windows 11/10
The most complete tiling window manager for Windows
Your windows.<br>Finally in order.
LazyWM is a fast, keyboard-driven tiling window manager made for Windows 11. It keeps your desktop organized while staying out of your way.
Get started →<br>Explore configuration
01 Native .NET<br>02 TOML config<br>03 Multi-monitor
DESKTOP 01<br>LAZYWM
01
02<br>> focus_right
window focused
03
1234<br>ALT + 1
01 / GETTING STARTED
Install and launch
LazyWM runs on Windows 11 and requires the .NET 10 Desktop Runtime.
Install .NET
Download and install the .NET 10 Desktop Runtime for Windows. You do not need the full developer SDK.
Download .NET 10 ↗
Download LazyWM
Download the latest LazyWM release and extract the archive to a permanent folder. Keep the included Config folder beside the executable.
View GitHub releases ↗
Launch LazyWM
Open the extracted folder and double-click lazywm.exe. LazyWM starts in the background and is controlled using its configured hotkeys.
Copy<br>.\lazywm.exe
Run on sign-in Place a shortcut to lazywm.exe in shell:startup after you are happy with your configuration.
02 / FIRST STEPS
Learn the essentials
Most daily actions use Alt as the leader key. Vim-style navigation and arrow-key alternatives are both supported.
Alt+H J K Lor← ↓ ↑ →<br>Move focus<br>Focus a window in any direction.
Alt+Shift+H J K Lor← ↓ ↑ →<br>Swap windows<br>Move the active window through the layout.
Alt+1…8<br>Change workspace<br>Jump directly to a workspace.
Alt+[ / ]<br>Resize split<br>Adjust the active layout split ratio.
Alt+Shift+S<br>Toggle stacked mode<br>Stack the windows in the active workspace or return to tiling.
Alt+Ctrl+O<br>Exit cleanly<br>Close LazyWM and restore managed windows to a visible state.
03 / FEATURES
Quietly capable
The core stays lightweight, while the details make a Windows desktop feel intentional.
COREAutomatic BSP tiling
New windows are placed into a balanced binary split layout, with configurable gaps and split ratios.
DESKTOPMulti-monitor workspaces
Move focus, windows, and whole workflows naturally across displays.
LAYOUTStacked mode
Group several windows into one tile and jump between them by number.
NAVIGATIONApplication switcher
Find open apps and empty workspaces from a compact keyboard-first interface.
FEEDBACKActive window border
Keep track of focus with configurable color, width, opacity, and rounded corners.
CONFIGLive configuration
Reload hotkeys and appearance settings without restarting your session.
04 / HOTKEYS
Keyboard reference
Defaults live in Config/HotKeyConfig.toml. Every key combination can be changed.
ActionDefaultConfig action
Open app switcherAlt Shift Spaceopen_app_switcher<br>Focus left / down / up / rightAlt H/J/K/Lfocus_*<br>Swap left / down / up / rightAlt Shift H/J/K/Lswap_*<br>Switch workspaceAlt 1…8switch_to_workspace<br>Move to workspaceAlt Shift 1…8move_to_workspace<br>Toggle stacked modeAlt Shift Stoggle_stacked_mode<br>Pause window managementAlt Ptoggle_paused_mode<br>Reload configurationAlt Ctrl Rreload_configuration<br>Exit LazyWMAlt Ctrl Oexit_application
05 / WORKSPACES
Separate spaces,<br>one flow
Each monitor has independent workspaces. Switch directly, move the focused window, or ask LazyWM to find the next free workspace automatically.
Up to eight directly addressable workspaces
Animated workspace transitions
Workspace swapping on the active monitor
Move windows to a free workspace on another monitor
06 / STACKED MODE
More windows,<br>same space
Stacked mode lets several applications share one tile. Cycle through the stack, reorder it, or jump to a position using configurable number keys.
Alt + SCycle the active stack
Ctrl + 1…9Jump to a stacked window
07 / CONFIGURATION
Make it yours
Configuration is plain TOML stored in the Config folder next to the executable.
config.tomlLogging, animations, and mouse behavior.
HotKeyConfig.tomlCommands and application shortcuts.
WorkspaceConfig.tomlLayouts, gaps, and workspace defaults.
WorkspaceIndicatorConfig.tomlTaskbar indicator layout and colors.
WindowBorderConfig.tomlActive window border appearance.
AppSwitcherConfig.tomlSwitcher dimensions and styling.
FloatingRulesConfig.tomlPersistent tiled and floating app rules.
Apply changes instantly Press Alt + Ctrl + R to reload configuration while LazyWM is running.
CONFIG / 01<br>Workspace layout
WorkspaceConfig.toml
Set workspace modes, inner and outer gaps, and the initial workspace for each monitor.
Copy<br># Workspace layout and spacing<br>[workspace]<br>initial_workspace = 1<br>window_gap = 0<br>outer_gap = 4<br>default_mode = "tiled"
CONFIG / 02<br>Workspace indicator
WorkspaceIndicatorConfig.toml
Control taskbar placement, visible workspaces, app icons, badges, and Windows accent color integration.
Copy<br>[workspace_indicator]<br>indicator_position = "center"<br>workspace_display_mode = "icons"<br>always_visible_workspaces = 8<br>show_app_switcher = "left"<br>native_windows_accent_color = true
CONFIG /...