The komorebi.json
static configuration file reference for v0.1.30
Animations configuration options
Set the animation duration in ms (default: 250)
Value must be greater or equal to 0.0
Enable or disable animations (default: false)
Set the animation FPS (default: 60)
Value must be greater or equal to 0.0
Set the animation style (default: Linear)
Path to applications.json from komorebi-application-specific-configurations (default: None)
Komorebi status bar configuration files for multiple instances on different monitors
No Additional ItemsDisplay an active window border (default: false)
Active window border colours for different container types
Border colour when the container is in floating mode
Colour represented as RGB
Blue
Value must be greater or equal to 0.0
Green
Value must be greater or equal to 0.0
Red
Value must be greater or equal to 0.0
Colour represented as Hex
Border colour when the container is in monocle mode
Colour represented as RGB
Blue
Value must be greater or equal to 0.0
Green
Value must be greater or equal to 0.0
Red
Value must be greater or equal to 0.0
Colour represented as Hex
Border colour when the container contains a single window
Colour represented as RGB
Blue
Value must be greater or equal to 0.0
Green
Value must be greater or equal to 0.0
Red
Value must be greater or equal to 0.0
Colour represented as Hex
Border colour when the container contains multiple windows
Colour represented as RGB
Blue
Value must be greater or equal to 0.0
Green
Value must be greater or equal to 0.0
Red
Value must be greater or equal to 0.0
Colour represented as Hex
Border colour when the container is unfocused
Colour represented as RGB
Blue
Value must be greater or equal to 0.0
Green
Value must be greater or equal to 0.0
Red
Value must be greater or equal to 0.0
Colour represented as Hex
Active window border implementation (default: Komorebi)
Use the adjustable komorebi border implementation
Use the thin Windows accent border implementation
Offset of the window border (default: -1)
Identify border overflow applications
No Additional ItemsActive window border style (default: System)
Use the system border style
Use the Windows 11-style rounded borders
Use the Windows 10-style square borders
Width of the window border (default: 8)
Active window border z-order (default: System)
Determine what happens when an action is called on a window at a monitor boundary (default: Monitor)
Attempt to perform actions across a workspace boundary
Attempt to perform actions across a monitor boundary
Determine what happens when a window is moved across a monitor boundary (default: Swap)
Swap the window container with the window container at the edge of the adjacent monitor
Insert the window container into the focused workspace on the adjacent monitor
Do nothing if trying to move a window container in the direction of an adjacent monitor
Global default container padding (default: 10)
Global default workspace padding (default: 10)
Set display index preferences
Each additional property must conform to the following schema
Type: stringEnable or disable float override, which makes it so every new window opens in floating mode (default: false)
Identify applications which should be managed as floating windows
No Additional ItemsEND OF LIFE FEATURE: Determine focus follows mouse implementation (default: None)
A custom FFM implementation (slightly more CPU-intensive)
The native (legacy) Windows FFM implementation
Global work area (space used for tiling) offset (default: None)
The bottom point in a Win32 Rect
The left point in a Win32 Rect
The right point in a Win32 Rect
The top point in a Win32 Rect
Individual window floating rules
No Additional ItemsDEPRECATED from v0.1.22: no longer required
The bottom point in a Win32 Rect
The left point in a Win32 Rect
The right point in a Win32 Rect
The top point in a Win32 Rect
Identify applications that have the WSEXLAYERED extended window style
No Additional ItemsIndividual window force-manage rules
No Additional ItemsDISCOURAGED: Minimum height for a window to be eligible for tiling
DISCOURAGED: Minimum width for a window to be eligible for tiling
Set monitor index preferences
Each additional property must conform to the following schema
Type: objectThe bottom point in a Win32 Rect
The left point in a Win32 Rect
The right point in a Win32 Rect
The top point in a Win32 Rect
Monitor and workspace configurations
No Additional ItemsWindow based work area offset (default: None)
The bottom point in a Win32 Rect
The left point in a Win32 Rect
The right point in a Win32 Rect
The top point in a Win32 Rect
Open window limit after which the window based work area offset will no longer be applied (default: 1)
Monitor-specific work area offset (default: None)
The bottom point in a Win32 Rect
The left point in a Win32 Rect
The right point in a Win32 Rect
The top point in a Win32 Rect
Workspace configurations
No Additional ItemsApply this monitor's window-based work area offset (default: true)
Container padding (default: global)
END OF LIFE FEATURE: Custom Layout (default: None)
END OF LIFE FEATURE: Custom layout rules (default: None)
Each additional property must conform to the following schema
Type: stringEnable or disable float override, which makes it so every new window opens in floating mode (default: false)
Initial workspace application rules
No Additional ItemsLayout (default: BSP)
Layout rules (default: None)
Each additional property must conform to the following schema
Type: enum (of string)Name
Determine what happens when a new window is opened (default: Create)
Create a new container for each new window
Append new windows to the focused window container
Container padding (default: global)
Permanent workspace application rules
No Additional ItemsEnable or disable mouse follows focus (default: true)
Identify applications that send EVENTOBJECTNAMECHANGE on launch (very rare)
No Additional ItemsDelta to resize windows by (default 50)
How long to wait when compensating for slow applications, in milliseconds (default: 20)
Value must be greater or equal to 0.0
Identify applications which are slow to send initial event notifications
No Additional ItemsStackbar configuration options
Stackbar height
Stackbar label
Stackbar mode
Stackbar tab configuration options
Tab background colour
Colour represented as RGB
Blue
Value must be greater or equal to 0.0
Green
Value must be greater or equal to 0.0
Red
Value must be greater or equal to 0.0
Colour represented as Hex
Focused tab text colour
Colour represented as RGB
Blue
Value must be greater or equal to 0.0
Green
Value must be greater or equal to 0.0
Red
Value must be greater or equal to 0.0
Colour represented as Hex
Font family
Font size
Unfocused tab text colour
Colour represented as RGB
Blue
Value must be greater or equal to 0.0
Green
Value must be greater or equal to 0.0
Red
Value must be greater or equal to 0.0
Colour represented as Hex
Width of a stackbar tab
Theme configuration options
A theme from catppuccin-egui
Komorebi status bar accent (default: Blue)
Border colour when the window is floating (default: Yellow)
Border colour when the container is in monocle mode (default: Pink)
Name of the Catppuccin theme (theme previews: https://github.com/catppuccin/catppuccin)
Border colour when the container contains a single window (default: Blue)
Border colour when the container contains multiple windows (default: Green)
Stackbar tab background colour (default: Base)
Stackbar focused tab text colour (default: Green)
Stackbar unfocused tab text colour (default: Text)
Border colour when the container is unfocused (default: Base)
A theme from base16-egui-themes
Komorebi status bar accent (default: Base0D)
Border colour when the window is floating (default: Base09)
Border colour when the container is in monocle mode (default: Base0F)
Name of the Base16 theme (theme previews: https://tinted-theming.github.io/base16-gallery)
Border colour when the container contains a single window (default: Base0D)
Border colour when the container contains multiple windows (default: Base0B)
Stackbar tab background colour (default: Base01)
Stackbar focused tab text colour (default: Base0B)
Stackbar unfocused tab text colour (default: Base05)
Border colour when the container is unfocused (default: Base01)
Add transparency to unfocused windows (default: false)
Alpha value for unfocused window transparency [[0-255]] (default: 200)
Value must be greater or equal to 0.0
Individual window transparency ignore rules
No Additional ItemsIdentify tray and multi-window applications
No Additional ItemsDetermine what happens when commands are sent while an unmanaged window is in the foreground (default: Op)
Process komorebic commands on temporarily unmanaged/floated windows
Ignore komorebic commands on temporarily unmanaged/floated windows
Determine what happens when a new window is opened (default: Create)
Create a new container for each new window
Append new windows to the focused window container
Which Windows signal to use when hiding windows (default: Cloak)
Use the SW_HIDE flag to hide windows when switching workspaces (has issues with Electron apps)
Use the SW_MINIMIZE flag to hide windows when switching workspaces (has issues with frequent workspace switching)
Use the undocumented SetCloak Win32 function to hide windows when switching workspaces