# ################################################################ # # 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. # add an on_enter command to the default mode # :: default : yabai -m config active_window_border_color 0xff775759 # # defines a new mode 'test' with an on_enter command, that captures keypresses # :: test @ : yabai -m config active_window_border_color 0xff24ccaa # # from 'default' mode, activate mode 'test' # cmd - x ; test # # from 'test' mode, activate mode 'default' # test < cmd - x ; default # # launch a new terminal instance when in either 'default' or 'test' mode # default, test < cmd - return : open -na /Applications/Terminal.app # application specific bindings # #cmd - n [ # "kitty" : echo "hello kitty" # * : echo "hello everyone" # "qutebrowser" : echo "hello qutebrowser" # "terminal" ~ # "finder" : false #] # specify a file that should be included as an additional config-file. # treated as an absolutepath if the filename begins with '/' otherwise # the file is relative to the path of the config-file it was loaded from. # # .load "/Users/Koe/.config/partial_skhdrc" # .load "partial_skhdrc" # prevent skhd from monitoring events for specific applications. # # .blacklist [ # "kitty" # "terminal" # "qutebrowser" # ] # open terminal, blazingly fast compared to iTerm/Hyper cmd - return : /Applications/WezTerm.app/Contents/MacOS/wezterm start --always-new-process # open qutebrowser #cmd + shift - return : ~/Scripts/qtb.sh # open mpv #cmd - m : open -na /Applications/mpv.app $(pbpaste) # ############################################################### # # 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.. # # ############################################################### # # open mpv with url from clipboard #shift + cmd - m : mpv $(pbpaste) # focus window alt - x : yabai -m window --focus recent alt - left : yabai -m window --focus west alt - down : yabai -m window --focus south alt - up : yabai -m window --focus north alt - right : yabai -m window --focus east alt - z : yabai -m window --focus stack.prev alt - c : yabai -m window --focus stack.next # swap window #shift + alt - x : yabai -m window --swap recent #shift + alt - left : yabai -m window --swap west #shift + alt - down : yabai -m window --swap south #shift + alt - up : yabai -m window --swap north #shift + alt - right : yabai -m window --swap east # move window shift + cmd - left : yabai -m window --warp west shift + cmd - down : yabai -m window --warp south shift + cmd - up : yabai -m window --warp north shift + cmd - right : 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 # make floating window fill right-half of screen #shift + alt - right : yabai -m window --grid 1:2:1: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(."native-fullscreen" == 0))[-1].index')" && \ # yabai -m window --space "${index}" && \ # yabai -m space --focus "${index}" # create desktop and follow focus - uses jq for parsing json (brew install jq) # cmd + alt - n : yabai -m space --create && \ # index="$(yabai -m query --spaces --display | jq 'map(select(."native-fullscreen" == 0))[-1].index')" && \ # yabai -m space --focus "${index}" # destroy desktop # cmd + alt - w : yabai -m space --destroy cmd + alt - w : yabai -m space --focus prev && yabai -m space recent --destroy # fast focus desktop cmd + alt - b : yabai -m space --focus recent cmd + alt - n : yabai -m space --focus prev || skhd -k "ctrl + alt + cmd - z" cmd + alt - m : yabai -m space --focus next || skhd -k "ctrl + alt + cmd - c" cmd + alt - 1 : yabai -m space --focus 1 || skhd -k "ctrl + alt + cmd - 1" cmd + alt - 2 : yabai -m space --focus 2 || skhd -k "ctrl + alt + cmd - 2" cmd + alt - 3 : yabai -m space --focus 3 || skhd -k "ctrl + alt + cmd - 3" cmd + alt - 4 : yabai -m space --focus 4 || skhd -k "ctrl + alt + cmd - 4" cmd + alt - 5 : yabai -m space --focus 5 || skhd -k "ctrl + alt + cmd - 5" cmd + alt - 6 : yabai -m space --focus 6 || skhd -k "ctrl + alt + cmd - 6" cmd + alt - 7 : yabai -m space --focus 7 || skhd -k "ctrl + alt + cmd - 7" cmd + alt - 8 : yabai -m space --focus 8 || skhd -k "ctrl + alt + cmd - 8" cmd + alt - 9 : yabai -m space --focus 9 || skhd -k "ctrl + alt + cmd - 9" cmd + alt - 0 : yabai -m space --focus 10 || skhd -k "ctrl + alt + cmd - 0" # send window to desktop and follow focus shift + cmd - b : yabai -m window --space recent && yabai -m space --focus recent shift + cmd - n : yabai -m window --space prev && yabai -m space --focus prev shift + cmd - m : yabai -m window --space next && yabai -m space --focus next shift + cmd - 1 : yabai -m window --space 1 && yabai -m space --focus 1 shift + cmd - 2 : yabai -m window --space 2 && yabai -m space --focus 2 shift + cmd - 3 : yabai -m window --space 3 && yabai -m space --focus 3 shift + cmd - 4 : yabai -m window --space 4 && yabai -m space --focus 4 shift + cmd - 5 : yabai -m window --space 5 && yabai -m space --focus 5 shift + cmd - 6 : yabai -m window --space 6 && yabai -m space --focus 6 shift + cmd - 7 : yabai -m window --space 7 && yabai -m space --focus 7 shift + cmd - 8 : yabai -m window --space 8 && yabai -m space --focus 8 shift + cmd - 9 : yabai -m window --space 9 && yabai -m space --focus 9 shift + cmd - 0 : yabai -m window --space 10 && yabai -m space --focus 10 # focus monitor ctrl + alt - x : yabai -m display --focus recent ctrl + alt - z : yabai -m display --focus prev ctrl + alt - c : yabai -m display --focus next ctrl + alt - 1 : yabai -m display --focus 1 ctrl + alt - 2 : yabai -m display --focus 2 ctrl + alt - 3 : yabai -m display --focus 3 # send window to monitor and follow focus ctrl + cmd - x : yabai -m window --display recent && yabai -m display --focus recent ctrl + cmd - z : yabai -m window --display prev && yabai -m display --focus prev 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 ctrl + cmd - 2 : yabai -m window --display 2 && yabai -m display --focus 2 ctrl + cmd - 3 : yabai -m window --display 3 && yabai -m display --focus 3 # move window #shift + ctrl - left : yabai -m window --move rel:-20:0 #shift + ctrl - down : yabai -m window --move rel:0:20 #shift + ctrl - up : yabai -m window --move rel:0:-20 #shift + ctrl - right : yabai -m window --move rel:20:0 # increase window size shift + alt - left : yabai -m window --resize left:-20:0 shift + alt - down : yabai -m window --resize bottom:0:20 shift + alt - up : yabai -m window --resize top:0:-20 shift + alt - right : yabai -m window --resize right:20:0 # decrease window size shift + ctrl - left : yabai -m window --resize left:20:0 shift + ctrl - down : yabai -m window --resize bottom:0:-20 shift + ctrl - up : yabai -m window --resize top:0:20 shift + ctrl - right : yabai -m window --resize right:-20:0 # set insertion point in focused container ctrl + alt - h : yabai -m window --insert west ctrl + alt - j : yabai -m window --insert south ctrl + alt - k : yabai -m window --insert north ctrl + alt - l : yabai -m window --insert east ctrl + alt - i : yabai -m window --insert stack # rotate tree alt - r : yabai -m space --rotate 90 # mirror tree y-axis alt - y : yabai -m space --mirror y-axis # mirror tree x-axis alt - x : yabai -m space --mirror x-axis # toggle desktop offset alt - a : yabai -m space --toggle padding --toggle gap # toggle window parent zoom alt - d : yabai -m window --toggle zoom-parent # toggle window fullscreen zoom alt - f : yabai -m window --toggle zoom-fullscreen # toggle window native fullscreen shift + alt - f : yabai -m window --toggle native-fullscreen # toggle window split type alt - e : yabai -m window --toggle split # float / unfloat window and restore position # alt - t : yabai -m window --toggle float && /tmp/yabai-restore/$(yabai -m query --windows --window | jq -re '.id').restore 2>/dev/null || true shift + cmd - space : yabai -m window --toggle float --grid 4:4:1:1:2:2 # toggle sticky (show on all spaces) alt - s : yabai -m window --toggle sticky # toggle topmost (keep above other windows) alt - o : yabai -m window --toggle topmost # toggle picture-in-picture alt - p : yabai -m window --toggle border --toggle pip # Screenshot alt + shift - p : screencapture -oWx ~/Pictures/"$(TZ=UTC date '+%F_%H-%M-%S')".png # change layout of desktop ctrl + alt - a : yabai -m space --layout bsp ctrl + alt - d : yabai -m space --layout float ctrl + alt - s : yabai -m space --layout $(yabai -m query --spaces --space | jq -r 'if .type == "bsp" then "float" else "bsp" end') cmd + shift - y : ~/.config/choose/choose-pass.sh cmd - y : ~/.config/choose/choose-clip.sh cmd + shift - q : kill $(~/scripts/get_current-window.py pid) cmd + shift - r : yabai --restart-service && skhd --restart-service