# ################################################################ # # THE FOLLOWING IS AN EXPLANATION OF THE GRAMMAR THAT SKHD PARSES. # # FOR SIMPLE EXAMPLE MAPPINGS LOOK FURTHER DOWN THIS FILE.. # # ################################################################ # # A list of all built-in modifier and literal keywords can # be found at https://github.com/koekeishiya/skhd/issues/1 # # A hotkey is written according to the following rules: # # hotkey = '<' | # # mode = 'name of mode' | ',' # # action = '[' ']' | '->' '[' ']' # ':' | '->' ':' # ';' | '->' ';' # # keysym = '-' | # # mod = 'modifier keyword' | '+' # # key = | # # literal = 'single letter or built-in keyword' # # keycode = 'apple keyboard kVK_ values (0x3C)' # # proc_map_lst = * # # proc_map = ':' | '~' | # '*' ':' | '*' '~' # # string = '"' 'sequence of characters' '"' # # command = command is executed through '$SHELL -c' and # follows valid shell syntax. if the $SHELL environment # variable is not set, it will default to '/bin/bash'. # when bash is used, the ';' delimeter can be specified # to chain commands. # # to allow a command to extend into multiple lines, # prepend '\' at the end of the previous line. # # an EOL character signifies the end of the bind. # # -> = keypress is not consumed by skhd # # * = matches every application not specified in # # ~ = application is unbound and keypress is forwarded per usual, when specified in a # # A mode is declared according to the following rules: # # mode_decl = '::' '@' ':' | '::' ':' | # '::' '@' | '::' # # name = desired name for this mode, # # @ = capture keypresses regardless of being bound to an action # # command = command is executed through '$SHELL -c' and # follows valid shell syntax. if the $SHELL environment # variable is not set, it will default to '/bin/bash'. # when bash is used, the ';' delimeter can be specified # to chain commands. # # to allow a command to extend into multiple lines, # prepend '\' at the end of the previous line. # # an EOL character signifies the end of the bind. # ############################################################### # # THE FOLLOWING SECTION CONTAIN SIMPLE MAPPINGS DEMONSTRATING HOW # # TO INTERACT WITH THE YABAI WM. THESE ARE SUPPOSED TO BE USED AS # # A REFERENCE ONLY, WHEN MAKING YOUR OWN CONFIGURATION.. # # ############################################################### # # focus window # alt - h : yabai -m window --focus west # swap managed window # shift + alt - h : yabai -m window --swap north # move managed window # shift + cmd - h : yabai -m window --warp east # balance size of windows # shift + alt - 0 : yabai -m space --balance # make floating window fill screen # shift + alt - up : yabai -m window --grid 1:1:0:0:1:1 # make floating window fill left-half of screen # shift + alt - left : yabai -m window --grid 1:2:0:0:1:1 # create desktop, move window and follow focus - uses jq for parsing json (brew install jq) # shift + cmd - n : yabai -m space --create && \ # index="$(yabai -m query --spaces --display | jq 'map(select(."is-native-fullscreen" == false))[-1].index')" && \ # yabai -m window --space "${index}" && \ # yabai -m space --focus "${index}" # fast focus desktop # cmd + alt - x : yabai -m space --focus recent # cmd + alt - 1 : yabai -m space --focus 1 # send window to desktop and follow focus # shift + cmd - z : yabai -m window --space next; yabai -m space --focus next # shift + cmd - 2 : yabai -m window --space 2; yabai -m space --focus 2 # focus monitor # ctrl + alt - z : yabai -m display --focus prev # ctrl + alt - 3 : yabai -m display --focus 3 # send window to monitor and follow focus # ctrl + cmd - c : yabai -m window --display next; yabai -m display --focus next # ctrl + cmd - 1 : yabai -m window --display 1; yabai -m display --focus 1 # move floating window # shift + ctrl - a : yabai -m window --move rel:-20:0 # shift + ctrl - s : yabai -m window --move rel:0:20 # increase window size # shift + alt - a : yabai -m window --resize left:-20:0 # shift + alt - w : yabai -m window --resize top:0:-20 # decrease window size # shift + cmd - s : yabai -m window --resize bottom:0:-20 # shift + cmd - w : yabai -m window --resize top:0:20 # set insertion point in focused container # ctrl + alt - h : yabai -m window --insert west # toggle window zoom # alt - d : yabai -m window --toggle zoom-parent # alt - f : yabai -m window --toggle zoom-fullscreen # toggle window split type # alt - e : yabai -m window --toggle split # float / unfloat window and center on screen # alt - t : yabai -m window --toggle float --grid 4:4:1:1:2:2 # toggle sticky(+float), topmost, picture-in-picture # alt - p : yabai -m window --toggle sticky --toggle topmost --toggle pip cmd + shift - space : yabai -m space --layout "$(yabai -m query --spaces --space | jq -r 'if .type == "bsp" then "stack" else "bsp" end')" # focus window in bsp mode cmd + shift - h: yabai -m window --focus west cmd + shift - j: yabai -m window --focus south cmd + shift - k: yabai -m window --focus north cmd + shift - l: yabai -m window --focus east cmd + shift - p: yabai -m window --focus stack.prev cmd + shift - n: yabai -m window --focus stack.next cmd + shift - f: yabai -m window --focus stack.first cmd + shift - g: yabai -m window --focus stack.last # fast focus desktop cmd - left : yabai -m space --focus prev cmd - right : yabai -m space --focus next cmd - z : yabai -m space --focus recent cmd - 1 : yabai -m space --focus 1 cmd - 2 : yabai -m space --focus 2 cmd - 3 : yabai -m space --focus 3 cmd - 4 : yabai -m space --focus 4 cmd - 5 : yabai -m space --focus 5 cmd - 6 : yabai -m space --focus 6 cmd - 7 : yabai -m space --focus 7 cmd - 8 : yabai -m space --focus 8 cmd - 9 : yabai -m space --focus 9 cmd - 0 : yabai -m space --focus 10 cmd + shift - 1 : yabai -m window --space 1; yabai -m space --focus 1 cmd + shift - 2 : yabai -m window --space 2; yabai -m space --focus 2 cmd + shift - 3 : yabai -m window --space 3; yabai -m space --focus 3 cmd + shift - 4 : yabai -m window --space 4; yabai -m space --focus 4 cmd + shift - 5 : yabai -m window --space 5; yabai -m space --focus 5 cmd + shift - 6 : yabai -m window --space 6; yabai -m space --focus 6 cmd + shift - 7 : yabai -m window --space 7; yabai -m space --focus 7 cmd + shift - 8 : yabai -m window --space 8; yabai -m space --focus 8 cmd + shift - 9 : yabai -m window --space 9; yabai -m space --focus 9 cmd + shift - 0 : yabai -m window --space 10; yabai -m space --focus 10 cmd + shift - return : /Applications/Alacritty.app/Contents/MacOS/alacritty cmd + shift - o : /Applications/Arc.app/Contents/MacOS/Arc