Sidebar
Tiling Window Managers
youtu.be
I put together a proof of concept for controlling a tiling window manager using voice commands. Hopefully this can make twm workflows easier for people who suffer from RSI or for whom keyboard shortcuts are impractical. I think that this approach can be replicated for any tiling window manager that exposes a CLI interface to send interaction messages (bspwm, yabai, etc)
www.youtube.com
To accompany the latest release of komorebi, I have created a brand new quickstart video! https://github.com/LGUG2Z/komorebi/releases/tag/v0.1.17
So I use `komorebi` on Windows, `yabai` on macOS and `bspwm` on Linux. They are all kinda similar, but at the same time have different feature sets which make certain workflows possible on one but not the other. How do you handle this problem if you are someone regularly switches between operating systems? Personally, I've started restricting myself as much as possible to using just the features and workflows that can be reproduced across all operating systems and twms, so that when I switch, there isn't any one thing that I'm missing "too much" that the experience gets soured and my productivity tanks.
github.com
<p align="center"> <img width="75%" src="assets/banner/banner.svg" alt="Banner"> </p> <p align="center"> <b>Tiling window management for the Mac.</b> </p> <p align="center"> <a href="https://github.com/koekeishiya/yabai/blob/master/LICENSE.txt"> <img src="https://img.shields.io/github/license/koekeishiya/yabai.svg?color=green" alt="License Badge"> </a> <a href="https://github.com/koekeishiya/yabai/blob/master/doc/yabai.asciidoc"> <img src="https://img.shields.io/badge/view-documentation-green.svg" alt="Documentation Badge"> </a> <a href="https://github.com/koekeishiya/yabai/wiki"> <img src="https://img.shields.io/badge/view-wiki-green.svg" alt="Wiki Badge"> </a> <a href="https://github.com/koekeishiya/yabai/blob/master/CHANGELOG.md"> <img src="https://img.shields.io/badge/view-changelog-green.svg" alt="Changelog Badge"> </a> <a href="https://github.com/koekeishiya/yabai/releases"> <img src="https://img.shields.io/github/commits-since/koekeishiya/yabai/latest.svg?color=green" alt="Version Badge"> </a> </p> ## About <img align="right" width="40%" src="assets/screenshot.png" alt="Screenshot"> yabai is a window management utility that is designed to work as an extension to the built-in window manager of macOS. yabai allows you to control your windows, spaces and displays freely using an intuitive command line interface and optionally set user-defined keyboard shortcuts using [↗ skhd][gh-skhd] and other third-party software. The primary function of yabai is tiling window management; automatically modifying your window layout using a binary space partitioning algorithm to allow you to focus on the content of your windows without distractions. Additional features of yabai include focus-follows-mouse, disabling animations for switching spaces, creating spaces past the limit of 16 spaces, and much more. ## Installation and Configuration - The [↗ yabai wiki][yabai-wiki] has both brief and detailed installation instructions for multiple installation methods, and also explains how to uninstall yabai completely. - Sample configuration files can be found in the [↗ examples][yabai-examples] directory. Refer to the [↗ documentation][yabai-docs] or the wiki for further information. - Keyboard shortcuts can be defined with [↗ skhd][gh-skhd] or any other suitable software you may prefer. ## Requirements and Caveats Please read the below requirements carefully. Make sure you fulfil all of them before filing an issue. |Requirement|Note| |-:|:-| |Operating System Intel x86-64|Big Sur 11.0.1+ and Monterey 12.0.0+ is supported.| |Operating System Apple Silicon|Monterey 12.0.0+ is supported.| |Accessibility API|yabai must be given permission to utilize the Accessibility API and will request access upon launch. The application must be restarted after access has been granted.| |Screen Recording|yabai must be given Screen Recording permission if and only if you want to enable window animations, and will request access when necessary. The application must be restarted after access has been granted.| |Mission Control|In the Mission Control preferences pane in System Preferences, the setting "Displays have separate Spaces" must be enabled.| Please also take note of the following caveats. |Caveat|Note| |-:|:-| |System Integrity Protection|System Integrity Protection needs to be (partially) disabled for yabai to inject a scripting addition into Dock.app for controlling windows with functions that require elevated privileges. This enables control of the window server, which is the sole owner of all window connections, and enables additional features of yabai.| |Code Signing|When building from source (or installing from HEAD), it is recommended to codesign the binary so it retains its accessibility and automation privileges when updated or rebuilt.| |Mission Control|In the Mission Control preferences pane in System Preferences, the setting "Automatically rearrange Spaces based on most recent use" should be disabled for commands that rely on the ordering of spaces to work reliably.| ## License and Attribution yabai is licensed under the [↗ MIT License][yabai-license], a short and simple permissive license with conditions only requiring preservation of copyright and license notices. Licensed works, modifications, and larger works may be distributed under different terms and without source code. Thanks to [@fools-mate][gh-fools-mate] for creating a logo and banner for this project and making them available for free. Thanks to [@dominiklohmann][gh-dominiklohmann] for contributing great documentation, support, and more, for free. ## Disclaimer Use at your own discretion. I take no responsibility if anything should happen to your machine while trying to install, test or otherwise use this software in any form. You acknowledge that you understand the potential risk that may come from disabling [↗ System Integrity Protection][external-about-sip] on your system, and I make no recommendation as to whether you should or should not disable System Integrity Protection. <!-- Project internal links --> [yabai-license]: LICENSE.txt [yabai-examples]: https://github.com/koekeishiya/yabai/tree/master/examples [yabai-wiki]: https://github.com/koekeishiya/yabai/wiki [yabai-docs]: https://github.com/koekeishiya/yabai/blob/master/doc/yabai.asciidoc <!-- Links to other GitHub projects/users --> [gh-skhd]: https://github.com/koekeishiya/skhd [gh-fools-mate]: https://github.com/fools-mate [gh-dominiklohmann]: https://github.com/dominiklohmann <!-- External links --> [external-about-sip]: https://support.apple.com/en-us/HT204899
github.com
In the hope that other developers join this community, I'll get things rolling! I'm LGUG2Z and I'm the developer of `komorebi` for Windows which is heavily inspired by my experiences with `bspwm` and `yabai` 👋 