Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/julian-heng/yabai-config

My personal Yabai and Skhd configs and scripts.
https://github.com/julian-heng/yabai-config

dotfiles hjkl macos skhd yabai

Last synced: about 2 months ago
JSON representation

My personal Yabai and Skhd configs and scripts.

Awesome Lists containing this project

README

        

# Yabai and Skhd Config

This repository contains my standalone Yabai and Skhd configurations.

See my [dotfiles](https://gitlab.com/julian-heng/dotfiles.git) repository for my other configurations.

To see the old Chunkwm configurations, click [here](https://github.com/Julian-Heng/yabai-config/tree/old).

NOTE: Yabai requires System Integrity Protection to be disabled to work properly. See [here](https://github.com/koekeishiya/yabai/wiki/Disabling-System-Integrity-Protection) for more information.
NOTE: For macOS Big Sur and above, scripting additions needs elevated privileges to work properly. See [here]() for more information.

## Installation

```sh
# 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](https://github.com/lavoiesl/osx-cpu-temp) installed. The song script supports Spotify, Music and cmus.

Click [here](scripts) 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](scripts/open_iterm2.sh) to view the script.

#### Key Combination

alt + return

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