yabai - GitLite

KO | EN

gitlite — search

#python #react #ai #typescript #llm #rust #linux #docker #macos #awesome #cli #kubernetes #awesome-list #pytorch

yabai

(★ 29,488)

바이너리 스페이스 파티셔닝(BSP) 기반의 macOS용 타일링 윈도우 매니저

파일 탐색기

최종 버전 다운로드 (.zip)

- FUNDING.yml
- - banner.png
  - banner.svg
- - icon.png
  - icon.svg
- Info.plist
- screenshot.png
- yabai.1
- yabai.asciidoc
- skhdrc
- yabairc
- codesign
- install.sh
- seticon.py
- - autorelease.h
  - extern.h
  - hashtable.h
  - helpers.h
  - log.h
  - macho_dlsym.h
  - macros.h
  - memory_pool.h
  - notify.h
  - sbuffer.h
  - service.h
  - timer.h
  - ts.h
- - arm64_payload.m
  - common.h
  - loader.m
  - payload.m
  - x64_payload.m
- application.c
- application.h
- display.c
- display.h
- display_manager.c
- display_manager.h
- event_loop.c
- event_loop.h
- event_signal.c
- event_signal.h
- manifest.m
- message.c
- message.h
- mission_control.c
- mouse_handler.c
- mouse_handler.h
- process_manager.c
- process_manager.h
- rule.c
- rule.h
- sa.h
- sa.m
- space.c
- space.h
- space_manager.c
- space_manager.h
- view.c
- view.h
- window.c
- window.h
- window_manager.c
- window_manager.h
- workspace.h
- workspace.m
- yabai.c
- - area.c
  - tests.m
- makefile
.gitignore
CHANGELOG.md
LICENSE.txt
makefile
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/asmvik/yabai

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd yabai

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Make

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![Banner](assets/banner/banner.svg)

**Mac을 위한 타일링 윈도우 관리자입니다.**

[![License Badge](https://img.shields.io/github/license/asmvik/yabai.svg?color=green)](https://github.com/asmvik/yabai/blob/master/LICENSE.txt)
[![Documentation Badge](https://img.shields.io/badge/view-documentation-green.svg)](https://github.com/asmvik/yabai/blob/master/doc/yabai.asciidoc)
[![Wiki Badge](https://img.shields.io/badge/view-wiki-green.svg)](https://github.com/asmvik/yabai/wiki)
[![Changelog Badge](https://img.shields.io/badge/view-changelog-green.svg)](https://github.com/asmvik/yabai/blob/master/CHANGELOG.md)
[![Version Badge](https://img.shields.io/github/commits-since/asmvik/yabai/latest.svg?color=green)](https://github.com/asmvik/yabai/releases)

## 소개
![Screenshot](assets/screenshot.png)
yabai는 macOS의 기본 내장 윈도우 관리자의 확장 프로그램으로 작동하도록 설계된 윈도우 관리 유틸리티입니다.
yabai를 사용하면 직관적인 명령 줄 인터페이스를 통해 윈도우, 스페이스, 디스플레이를 자유롭게 제어할 수 있으며, 선택적으로 [↗ skhd][gh-skhd] 및 기타 타사 소프트웨어를 사용하여 사용자 정의 키보드 단축키를 설정할 수 있습니다.
yabai의 주된 기능은 타일링 윈도우 관리입니다. 바이너리 공간 분할(binary space partitioning) 알고리즘을 사용하여 윈도우 레이아웃을 자동으로 수정함으로써 방해 요소 없이 윈도우의 콘텐츠에 집중할 수 있도록 해줍니다.
yabai의 추가 기능으로는 마우스 따라오기(focus-follows-mouse), 스페이스 전환 애니메이션 비활성화, 16개 스페이스 제한을 초과하는 스페이스 생성 등이 있습니다.

## 설치 및 설정
- [↗ yabai wiki][yabai-wiki]에는 다양한 설치 방법에 대한 간략하고 자세한 설치 지침이 모두 나와 있으며, yabai를 완전히 제거하는 방법도 설명되어 있습니다.
- 예제 설정 파일은 [↗ examples][yabai-examples] 디렉토리에서 확인할 수 있습니다. 자세한 내용은 [↗ documentation][yabai-docs] 또는 위키를 참고하세요.
- 키보드 단축키는 [↗ skhd][gh-skhd] 또는 선호하는 기타 적절한 소프트웨어를 사용하여 정의할 수 있습니다.

## 요구 사항 및 주의사항
아래 요구 사항을 주의 깊게 읽어주세요.
이슈를 제기하기 전에 모든 요구 사항을 충족하는지 확인하세요.

|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+, Tahoe 26.0+가 지원됩니다.|
|Operating System Apple Silicon|Monterey 12.0.0+, Ventura 13.0.0+, Sonoma 14.0.0+, Sequoia 15.0+, Tahoe 26.0+가 지원됩니다.|
|Accessibility API|yabai는 손쉬운 사용(Accessibility) API를 사용할 수 있는 권한이 있어야 하며, 실행 시 권한을 요청합니다. 권한이 부여된 후에는 애플리케이션을 재시작해야 합니다.|
|Screen Recording|윈도우 애니메이션을 활성화하려는 경우에만 yabai에 화면 기록(Screen Recording) 권한이 부여되어야 하며, 필요한 경우 권한을 요청합니다. 권한이 부여된 후에는 애플리케이션을 재시작해야 합니다.|
|System Preferences (macOS 11.x, 12.x)|Mission Control 창에서 "디스플레이마다 별도의 스페이스 가짐" 설정이 활성화되어 있어야 합니다.|
|System Settings (macOS 13.x, 14.x, 15.x, 26.x)|데스크탑 및 Dock 탭의 Mission Control 창 안에서 "디스플레이마다 별도의 스페이스 가짐" 설정이 활성화되어 있어야 합니다.|

다음 주의사항도 참고해 주세요.

|Caveat|Note|
|-:|:-|
|System Integrity Protection (Optional)|높은 권한이 필요한 기능으로 윈도우를 제어하기 위해 Dock.app에 스크립팅 추가 기능을 주입하도록 yabai의 시스템 무결성 보호(SIP)를 (부분적으로) 비활성화할 수 있습니다. 이를 통해 모든 윈도우 연결의 유일한 소유자인 윈도우 서버를 제어할 수 있으며, yabai의 추가 기능을 사용할 수 있게 됩니다.|
|Code Signing|소스에서 빌드하거나(또는 HEAD에서 설치하는 경우) 업데이트되거나 재빌드될 때 손쉬운 사용 및 자동화 권한을 유지하도록 바이너리에 코드 서명을 하는 것이 필수적입니다.|
|Finder Desktop|일부 사용자는 문서화되지 않은 defaults write 명령을 사용하여 Finder 데스크탑 윈도우를 비활성화합니다. 이로 인해 빈 스페이스 포커싱이 깨지므로 yabai를 사용할 때는 피해야 합니다. Finder 데스크탑을 다시 활성화하려면 다음을 실행하세요: "defaults write com.apple.finder CreateDesktop -bool true".|
|NSDocument-based Applications|Terminal 및 Finder와 같은 네이티브 macOS 탭을 사용하는 윈도우는 [탭을 생성할 때 올바르게 동작하지 않습니다](https://github.com/asmvik/yabai/issues/68). 이러한 애플리케이션에서 탭 생성을 피하고, NSDocument의 탭 시스템을 사용하지 않는 대안을 고려하거나, 규칙을 사용하여 해당 윈도우를 플로팅(float) 처리하세요.|
|System Preferences (macOS 11.x, 12.x)|스페이스의 순서에 의존하여 안정적으로 작동해야 하는 명령어의 경우, Mission Control 창에서 "최근 사용한 공간에 따라 자동으로 공간 재정렬" 설정이 비활성화되어 있어야 합니다.|
|System Settings (macOS 13.x, 14.x, 15.x, 26.x)|데스크탑 및 Dock 탭의 Mission Control 창 안에서 "자동으로 스페이스 재정렬

ange Spaces based on most recent use" 설정은 스페이스의 순서에 의존하는 명령어들이 안정적으로 작동하도록 하려면 비활성화해야 합니다.|
|System Settings (macOS 14.x, 15.x, 26.x)|Desktop & Dock 탭의 Desktop & Stage Manager 창 안에서, 다중 디스플레이 구성에서 디스플레이 및 스페이스 포커스 명령어가 안정적으로 작동하려면 "Show Items On Desktop" 설정이 활성화되어 있어야 합니다.|
|System Settings (macOS 14.x, 15.x, 26.x)|Desktop & Dock 탭의 Desktop & Stage Manager 창 안에서, 디스플레이 및 스페이스 포커스 명령어가 안정적으로 작동하려면 "Click wallpaper to reveal Desktop" 설정이 "Only in Stage Manager"로 설정되어 있어야 합니다.|
## 라이선스 및 저작권 표시
yabai는 [↗ MIT License][yabai-license]에 따라 라이선스가 부여됩니다. 이는 저작권 및 라이선스 고지의 보존만을 요구하는 조건이 있는 짧고 간단한 허용적 라이선스입니다.
라이선스가 부여된 저작물, 수정본 및 더 큰 저작물은 다른 조건으로 소스 코드 없이 배포될 수 있습니다.
이 프로젝트의 로고와 배너를 만들어 무료로 제공해 주신 [@fools-mate][gh-fools-mate]님께 감사드립니다.
훌륭한 문서화, 지원 등을 무료로 기여해 주신 [@dominiklohmann][gh-dominiklohmann]님께 감사드립니다.
## 면책 조항
사용자의 재량에 따라 사용하십시오.
이 소프트웨어를 설치, 테스트 또는 기타 방식으로 어떤 형태든 사용하는 동안 사용자의 기기에 발생할 수 있는 일에 대해 저는 어떠한 책임도 지지 않습니다.
사용자는 시스템에서 [↗ System Integrity Protection][external-about-sip]을 비활성화할 때 발생할 수 있는 잠재적 위험을 이해하고 있음을 인정하며, 저는 System Integrity Protection을 비활성화해야 하는지 여부에 대해 어떠한 권고도 하지 않습니다.
[yabai-license]: LICENSE.txt
[yabai-examples]: https://github.com/asmvik/yabai/tree/master/examples
[yabai-wiki]: https://github.com/asmvik/yabai/wiki
[yabai-docs]: https://github.com/asmvik/yabai/blob/master/doc/yabai.asciidoc
[gh-skhd]: https://github.com/asmvik/skhd
[gh-fools-mate]: https://github.com/fools-mate
[gh-dominiklohmann]: https://github.com/dominiklohmann
[external-about-sip]: https://support.apple.com/en-us/HT204899