yabai README

The project's README from github.com/asmvik/yabai. As one markdown file: README.md.

Banner

Tiling window management for the Mac.

License Badge Documentation Badge Wiki Badge Changelog Badge Version Badge

About

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 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

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.0+, Monterey 12.0.0+, Ventura 13.0.0+, Sonoma 14.0.0+, Sequoia 15.0+, and Tahoe 26.0+ is supported.
Operating System Apple Silicon Monterey 12.0.0+, Ventura 13.0.0+, Sonoma 14.0.0+, Sequoia 15.0+, and Tahoe 26.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.
System Preferences (macOS 11.x, 12.x) In the Mission Control pane, the setting "Displays have separate Spaces" must be enabled.
System Settings (macOS 13.x, 14.x, 15.x, 26.x) In the Desktop & Dock tab, inside the Mission Control pane, the setting "Displays have separate Spaces" must be enabled.

Please also take note of the following caveats.

Caveat Note
System Integrity Protection (Optional) System Integrity Protection can 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 necessary to codesign the binary so it retains its accessibility and automation privileges when updated or rebuilt.
Finder Desktop Some people disable the Finder Desktop window using an undocumented defaults write command. This breaks focusing of empty spaces and should be avoided when using yabai. To re-activate the Finder Desktop, run: "defaults write com.apple.finder CreateDesktop -bool true".
NSDocument-based Applications Windows that utilize native macOS tabs such as Terminal and Finder, do not behave correctly when creating tabs. Avoid creating tabs in these applications, consider alternatives that do not use NSDocument's tab system, or make these windows float using rules.
System Preferences (macOS 11.x, 12.x) In the Mission Control pane, 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.
System Settings (macOS 13.x, 14.x, 15.x, 26.x) In the Desktop & Dock tab, inside the Mission Control pane, 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.
System Settings (macOS 14.x, 15.x, 26.x) In the Desktop & Dock tab, inside the Desktop & Stage Manager pane, the setting "Show Items On Desktop" should be enabled for display and space focus commands to work reliably in multi-display configurations.
System Settings (macOS 14.x, 15.x, 26.x) In the Desktop & Dock tab, inside the Desktop & Stage Manager pane, the setting "Click wallpaper to reveal Desktop" should be set to "Only in Stage Manager" for display and space focus commands to work reliably.

License and Attribution

yabai is licensed under the ↗ MIT 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 for creating a logo and banner for this project and making them available for free.

Thanks to @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 on your system, and I make no recommendation as to whether you should or should not disable System Integrity Protection.

yabai (asmvik/yabai)

Searching Database…

29.7K ·GitHub
Что это такое?Yabai — это оконный менеджер с мозаичным расположением окон для macOS, который расширяет встроенный оконный менеджер системы и автоматически раскладывает окна по алгоритму двоичного разбиения пространства (binary space partitioning).
Это отдельное приложение, которое я открываю, или что-то, что работает в фоне и управляется через терминал?Это фоновая утилита, которой управляют через собственный интерфейс командной строки; вы не взаимодействуете с окном, как с обычным приложением.
Как его установить и настроить?В README нет единой команды установки; нужно следовать вики yabai, где описано несколько способов установки и how to полностью удалить программу.
Нужно ли что-то ещё, чтобы настроить горячие клавиши?Сам yabai горячие клавиши не обрабатывает; его нужно связать с skhd (отдельным демоном горячих клавиш) или любым другим сторонним инструментом для назначения клавиш, чтобы запускать его команды.
Нужно ли отключать System Integrity Protection, чтобы им пользоваться?Частичное отключение SIP необязательно, но требуется для расширенных функций, так как yabai внедряет скриптовое дополнение в Dock.app, чтобы управлять сервером окон с повышенными привилегиями.
Работает ли он на Mac с процессорами Intel, или только на Apple Silicon?Поддерживаются оба варианта: для Mac на Intel нужна macOS Big Sur 11.0+, а для Mac на Apple Silicon — Monterey 12.0+, вплоть до текущей версии Tahoe 26.
Какие разрешения macOS ему нужны?Для управления окнами ему необходим доступ к Accessibility API, а если вы хотите включить анимацию окон, дополнительно требуется разрешение Screen Recording.
Что на самом деле делает двоичное разбиение пространства с моими окнами?Оно автоматически делит экран на дерево прямоугольных областей по мере открытия и закрытия окон, так что раскладка остаётся мозаичной без ручного изменения размеров.
Что ещё умеет yabai, кроме мозаичного расположения?Он также поддерживает фокус за курсором мыши (focus-follows-mouse), отключение анимации переключения рабочих столов и создание больше чем стандартных 16 рабочих столов (Spaces) macOS, а также некоторые другие дополнительные возможности.
Есть ли приложения, которые плохо работают с yabai?Приложения, использующие встроенные вкладки документов macOS, например Terminal и Finder, работают некорректно при создании вкладок под управлением yabai; рекомендуется не использовать вкладки в них или задать правила, чтобы такие окна были плавающими.
Можно ли вообще не отключать SIP?Да, функции, связанные с SIP, необязательны; базовое мозаичное расположение и управление окнами работают без изменения System Integrity Protection, оно нужно только для расширенных функций сервера окон.
Creator
asmvik
Size
7.3 MB
Stars
29.7K
Age
7y
Commits · 90 Days