/macos_tiling_de

Tiling Desktop Environment for MacOS, inspired by i3/Regolith

Primary LanguageShellGNU General Public License v3.0GPL-3.0

Keyboard focused Tiling Desktop Environment for MacOS

An attempt at recreating the i3/Regolith experience on MacOS.
Based on skhd, yabai, and spacebar.

Install

  1. Install Homebrew
  2. Clone this repo git clone https://github.com/deekue/macos_tiling_de
  3. cd macos_tiling_de
  4. bash install.sh
  5. reboot

Usage

  • The fn key is the base modifier. Only tested on a MacBook, YMMV. More bindings in progress...
  • fn + shift + ? opens the Key Bindings window
  • fn + return - opens the Alacritty terminal emulator
  • fn + shift + return - opens the Google Chrome web browser

Caveats / ToDos

  • MacOS SIP needs to be disabled for some Yabai features to work
    • see Yabai doc Disabling System Integrity Protection
    • TODO mark affected key binds in skhdrc
    • configure Mission Control hotkeys as alternative?
      • MacOS doesn't add a hotkey when a new Space is created?!
      • the plist for these hotkeys is opaque and undocumented
  • current fn mapping doesn't work with external PC keyboards :(