julian-heng / yabai-config

My personal Yabai and Skhd configs and scripts.

Yabai and Skhd Config

This repository contains my standalone Yabai and Skhd configurations.

See my dotfiles repository for my other configurations.

To see the old Chunkwm configurations, click here.

NOTE: Yabai requires System Integrity Protection to be disabled to work properly. See here for more information. NOTE: For macOS Big Sur and above, scripting additions needs elevated privileges to work properly. See here for more information.

Installation

# Remove previous links
$ rm -f "${HOME}"/.{yabai,skhd}rc

# Install configs
$ git clone https://github.com/Julian-Heng/yabai-config.git "${HOME}"/.config/yabai
$ ln -s "${HOME}/.config/yabai/yabairc" "${HOME}/.yabairc"
$ ln -s "${HOME}/.config/yabai/skhdrc" "${HOME}/.skhdrc"

Keyboard Shortcuts

Changing Focus

alt + hjkl

Resize Windows

Action	Key Combination
Resize left	lctrl + alt + h
Resize down	lctrl + alt + j
Resize up	lctrl + alt + k
Resize right	lctrl + alt + l
Equalise	lctrl + alt + e

Move Windows

shift + alt + hjkl

Move Windows to Workspace

Action	Key Combination
Send to last active desktop	shift + alt + m
Send to previous workplace	shift + alt + p
Send to next workplace	shift + alt + n
Send to workplace	shift + alt + num

Rotate Windows

Action	Key Combination
Rotate clockwise	alt + r
Rotate anticlockwise	shift + alt + r
Flip on x-axis	shift + alt + x
Flip on y-axis	shift + alt + y

Window Actions

Action	Key Combination
Fullscreen	alt + f
Native fullscreen	shift + alt + f

Window Insertion Point

Action	Key Combination
Insert left	shift + lctrl + alt + h
Insert down	shift + lctrl + alt + j
Insert up	shift + lctrl + alt + k
Insert right	shift + lctrl + alt + l

NOTE: To cancel insertion point, press the last inerstion key combination.

Misc

Action	Key Combination
Toggle float	shift + alt + space
Toggle gaps	lctrl + alt + g
Restart yabai	lctrl + shift + alt + r

Showing System Information

Description

Uses osascript to show information like CPU, memory, battery, etc. The CPU script requires osx-cpu-temp installed. The song script supports Spotify, Music and cmus.

Click here to view the script folder.

NOTE: May have to change the location of the scripts in skhdrc.

Key Combination

fn + lalt + num

Screenshots

fn + lalt - 1 : /path/to/script
fn + lalt - 2 : /path/to/script
fn + lalt - 3 : /path/to/script
...

Launch iTerm2

Description

Launches iTerm2.

Click here to view the script.

Key Combination

alt + return

alt - return : /path/to/launch/terminal