Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 8 days ago
JSON representation
My personal Yabai and Skhd configs and scripts.
- Host: GitHub
- URL: https://github.com/Julian-Heng/yabai-config
- Owner: julian-heng
- Created: 2018-01-21T16:37:49.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2021-05-01T07:30:49.000Z (over 3 years ago)
- Last Synced: 2024-07-02T18:10:01.126Z (4 months ago)
- Topics: dotfiles, hjkl, macos, skhd, yabai
- Language: Shell
- Homepage:
- Size: 1000 KB
- Stars: 483
- Watchers: 4
- Forks: 97
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
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
```