Skip to content

Instantly share code, notes, and snippets.

Created Nov 24, 2016
What would you like to do?
kwm config
This is a sample config for Kwm
The following statements can be used to set Kwms internal directory structure.
This is the root folder for Kwms files, the only thing this actually
specifies is the location of the 'init' script which Kwm runs upon startup.
Defaults to $HOME/.kwm
kwm_home /path/to/.kwm
This is the root folder in which all files included using 'include' must reside.
Defaults to $HOME/.kwm
kwm_include /path/to/.kwm/include
This is the folder in which all bsp-layouts managed by 'tree load' and 'tree save'
is loaded from / saved to. Defaults to $HOME/.kwm/layouts
kwm_layouts /path/to/.kwm/layouts
Commands prefixed with 'kwmc' will call
local functions corresponding to the
kwmc syntax.
To run an external program or command,
use the prefix 'exec' followed by command.
e.g 'exec mvim' would open macvim
Read file and execute commands as
if they were written inside kwmrc.
include filename
e.g: bindsym-commands in a separate file called 'binds'
include binds
Create variables that can be used in the below commands.
Variables are in file-scope and must be defined before
they can be used. Re-definition is also possible.
Variable names can not contain whitespace, where as
the value can.
define variable value
e.g: create a variable for the hyper-key
define hyper cmd+ctrl+alt+shift
kwmc bindsym hyper-h window -f west
// Set default values for screen padding
kwmc config padding 30 10 10 10
// Set default values for container gaps
kwmc config gap 5 5
// Default tiling mode for Kwm (bsp | monocle | float)
kwmc config tiling bsp
// Let Kwm listen for hotkeys
kwmc config hotkeys on
// Automatically float windows that fail to resize
kwmc config float-non-resizable on
// Automatically resize the window to its container
kwmc config lock-to-container on
// Set focus-follows-mouse-mode to autoraise
kwmc config focus-follows-mouse off
/* Focus-follows-mouse is temporarily disabled when
a floating window has focus */
kwmc config standby-on-float on
/* Center window when made floating */
kwmc config center-on-float on
/* The mouse will automatically move to the center
of the focused window */
kwmc config mouse-follows-focus on
/* Allows a window to be moved by dragging,
when a modifier key and left-click is held down. */
kwmc config mouse-drag off
/* The modifier keys to be held down to initiate mouse-drag */
kwmc config mouse-drag mod shift+ctrl
// Allow window focus to wrap-around
kwmc config cycle-focus on
/* Override default settings for space 1 on screen 0
kwmc config space 0 1 mode monocle
kwmc config space 0 1 padding 100 100 100 100
kwmc config space 0 1 gap 40 40 */
/* Override default settings for screen 1
kwmc config display 1 mode bsp
kwmc config display 1 padding 100 100 100 100
kwmc config display 1 gap 40 40 */
// Set default container split-ratio
kwmc config split-ratio 0.382
// New splits become the left leaf-node
kwmc config spawn left
/* Add custom tiling rules for applications that
does not get tiled by Kwm by default.
This is because some applications do not have the
AXWindowRole and AXStandardWindowSubRole */
/* The following commands create rules that
blacklists an application from Kwms tiling
kwmc rule owner="Steam" properties={float="true"}
kwmc rule owner="Photoshop" properties={float="true"} */
/* The following command creates a rule that
captures an application to the given screen,
if the screen exists.
kwmc rule owner="iTunes" properties={display="1"} */
// Enable border for focused window
kwmc config border focused on
kwmc config border focused size 2
kwmc config border focused color 0xFFBDD322
kwmc config border focused radius 4
// Enable border for marked window
kwmc config border marked on
kwmc config border marked size 2
kwmc config border marked color 0xFFCC5577
kwmc config border marked radius 0
// Enable the prefix mode
kwmc mode prefix prefix on
kwmc mode prefix timeout 0.5
kwmc mode prefix restore default
kwmc mode prefix color 0xFF458588
/* Default Keybinds */
// Activate prefix mode
kwmc bindsym ctrl-s mode activate prefix
// Quit Kwm
kwmc bindsym cmd+alt+ctrl-q quit
kwmc bindsym cmd+alt+ctrl-r config reload
kwmc bindsym cmd-return exec open -na /Applications/
// Set Space Tiling Mode To BSP
kwmc bindsym cmd+ctrl-a space -t bsp
// Set Space Tiling Mode To Monocle
kwmc bindsym cmd+ctrl-s space -t monocle
// Set Space Tiling Mode To Floating
kwmc bindsym cmd+ctrl-d space -t float
// Rotate Window-Tree By 90degrees (Clockwise)
kwmc bindsym cmd+ctrl-r tree rotate 90
// fload on laptop display
// Modify Container
kwmc bindsym prefix-s window -c split-mode toggle
kwmc bindsym prefix-h window -c reduce 0.05
kwmc bindsym prefix-l window -c expand 0.05
kwmc bindsym prefix-< window -c type toggle
// Set Temporary Window Container
kwmc bindsym prefix-f window -z fullscreen
kwmc bindsym prefix-d window -z parent
kwmc bindsym prefix-w window -t focused
// Mark Window
kwmc bindsym cmd+alt+ctrl-m window -mk focused
kwmc bindsym cmd+alt+ctrl-h window -mk west wrap
kwmc bindsym cmd+alt+ctrl-l window -mk east wrap
kwmc bindsym cmd+alt+ctrl-j window -mk south wrap
kwmc bindsym cmd+alt+ctrl-k window -mk north wrap
// Give Focus To Window
kwmc bindsym cmd+ctrl-h window -f west
kwmc bindsym cmd+ctrl-l window -f east
kwmc bindsym cmd+ctrl-j window -f south
kwmc bindsym cmd+ctrl-k window -f north
kwmc bindsym cmd+alt-n window -fm prev
kwmc bindsym cmd+alt-m window -fm next
// Give Focus To Screen
kwmc bindsym ctrl-1 space -fExperimental 1
kwmc bindsym ctrl-2 space -fExperimental 2
kwmc bindsym ctrl-3 space -fExperimental 3
kwmc bindsym ctrl-4 space -fExperimental 4
kwmc bindsym prefix-1 display -f 0
kwmc bindsym prefix-2 display -f 1
// Swap Focused Window
kwmc bindsym ctrl+alt-h window -s west
kwmc bindsym ctrl+alt-j window -s south
kwmc bindsym ctrl+alt-k window -s north
kwmc bindsym ctrl+alt-l window -s east
kwmc bindsym ctrl+alt-m window -s mark
// Pseudo containers
kwmc bindsym cmd+ctrl+alt-p tree -pseudo create
kwmc bindsym cmd+ctrl+alt-o tree -pseudo destroy
kwmc bindsym ctrl+alt-p window -s prev
kwmc bindsym ctrl+alt-n window -s next
// Detach Focused Window And Reinsert In Direction
kwmc bindsym ctrl+shift-k window -m north
kwmc bindsym ctrl+shift-l window -m east
kwmc bindsym ctrl+shift-j window -m south
kwmc bindsym ctrl+shift-h window -m west
// Detach Marked Window And Reinsert At Focused Window
kwmc bindsym ctrl+shift-x window -m mark
// Move Focused Window To Space
kwmc bindsym prefix+shift-h window -m space left
kwmc bindsym prefix+shift-l window -m space right
// Move Focused Window To Screen
kwmc bindsym ctrl+alt-1 window -m display 0
kwmc bindsym ctrl+alt-2 window -m display 1
kwmc bindsym ctrl+alt-3 window -m display 2
// Increase Container Gaps
kwmc bindsym prefix-x space -g increase horizontal
kwmc bindsym prefix-y space -g increase vertical
// Decrease Container Gaps
kwmc bindsym prefix+shift-x space -g decrease horizontal
kwmc bindsym prefix+shift-y space -g decrease vertical
// Increase Screen Padding
kwmc bindsym prefix-left space -p increase left
kwmc bindsym prefix-right space -p increase right
kwmc bindsym prefix-up space -p increase top
kwmc bindsym prefix-down space -p increase bottom
kwmc bindsym prefix-p space -p increase all
// Decrease Screen Padding
kwmc bindsym prefix+shift-left space -p decrease left
kwmc bindsym prefix+shift-right space -p decrease right
kwmc bindsym prefix+shift-up space -p decrease top
kwmc bindsym prefix+shift-down space -p decrease bottom
kwmc bindsym prefix+shift-p space -p decrease all
// Autowrite
kwmc bindsym cmd-7 write \
kwmc bindsym cmd-8 write {
kwmc bindsym cmd-9 write }
// reload
// rules
kwmc rule properties={float="true"} role="AXDialog"
kwmc rule owner="FocusList" properties={role="AXDialog"}
kwmc rule owner="FocusList" role="AXDialog" properties={float="false"}
kwmc rule owner="Emacs" properties={role="AXStandardWindow"}
kwmc rule properties={float="true"} owner="App Store"
kwmc rule properties={float="true"} owner="System Preferences"
kwmc rule properties={float="true"} owner="Lingon X"
kwmc rule properties={float="true"} owner="Alfred Preferences"
kwmc rule properties={float="true"} owner="BetterTouchTool"
kwmc rule properties={float="true"} owner="Transmission"
kwmc rule properties={float="true"} owner="Archive Utility"
kwmc rule properties={float="true"} owner="The Unarchiver"
kwmc rule properties={float="true"} owner="Simulator"
kwmc rule properties={float="true"} owner="VOX"
kwmc rule properties={float="true"} owner="Android Emulator"
kwmc rule properties={float="true"} owner="qemu-system-x86_64"
kwmc rule properties={float="true"} owner="Snapper"
kwmc rule properties={float="true"} owner="Playback"
kwmc rule properties={float="true"} owner="VLC"
kwmc rule properties={float="true"} owner="Finder"
kwmc rule properties={float="true"} owner="Hearthstone"
kwmc rule properties={float="true"} name="Preferences"
kwmc rule properties={space="2"} owner="Reeder"
kwmc rule properties={space="3"} owner="Wunderlist"
kwmc rule properties={space="3"} owner="FocusList"
kwmc rule properties={space="3"} owner="Google Keep"
kwmc rule properties={space="3"} owner="Boxy"
kwmc rule properties={space="4"} owner="Slack"
kwmc rule properties={space="4"} owner="Discord"
kwmc rule properties={space="4"} owner="Messenger for Desktop"
kwmc rule properties={space="5"} owner="YouTube"
kwmc rule properties={space="5"} owner="Pocket Casts"
kwmc rule properties={space="5"} owner="Plex"
kwmc rule properties={space="5"} owner="Radiant Player"
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment