mirror of
https://github.com/LGUG2Z/komorebi.git
synced 2026-11-16 05:41:16 +01:00
69 lines
2.5 KiB
Markdown
69 lines
2.5 KiB
Markdown
# Getting started
|
|
|
|
`komorebi` is a tiling window manager for macOS that is comprised of two
|
|
main binaries, `komorebi`, which contains the window manager itself,
|
|
and `komorebic`, which is the main way to send commands to the tiling
|
|
window manager.
|
|
|
|
It is important to note that neither `komorebi` nor `komorebic` handle
|
|
key bindings, because `komorebi` is a tiling window manager and not a hotkey
|
|
daemon.
|
|
|
|
This getting started guide suggests the installation of
|
|
[`skhd`](https://github.com/koekeishiya/skhd) to allow you to bind `komorebic`
|
|
commands to hotkeys to allow you to communicate with the tiling window manager
|
|
using keyboard shortcuts.
|
|
|
|
## Installation
|
|
|
|
At this time users must compile `komorebi` from source.
|
|
|
|
## System settings suggestions
|
|
|
|
Go to `System Settings -> Desktop & Dock -> Mission Control -> Displays have
|
|
separate Spaces` and disable this option if you are using more than one monitor.
|
|
|
|
`komorebi` is scoped to a single macOS space (the one that is active when the
|
|
process is started), which means that you can still use other Spaces as if
|
|
`komorebi` were not running at all. If you are using monitors with the above
|
|
option enabled, komorebi will only be listening to events from the Space on the
|
|
monitor which it was launched on.
|
|
|
|
Go to `System Settings -> Desktop & Dock -> Mission Control -> Group windows
|
|
by application` and disable this option if you like to use mission control.
|
|
|
|
## Building from source
|
|
|
|
Make sure you have installed [`rustup`](https://rustup.rs), and a stable `rust`
|
|
compiler toolchain.
|
|
|
|
Clone the git repository, enter the directory, and build the following binaries:
|
|
|
|
```powershell
|
|
cargo +stable install --path komorebi --locked --target-dir ~/.cargo/bin
|
|
cargo +stable install --path komorebic --locked --target-dir ~/.cargo/bin
|
|
cargo +stable install --path komorebi-bar --locked --target-dir ~/.cargo/bin
|
|
```
|
|
|
|
If the binaries have been built and added to your `$PATH` correctly, you should
|
|
see some output when running `komorebi --help` and `komorebic --help`
|
|
|
|
Once komorebi is installed, proceed to get
|
|
the [example configurations](example-configurations.md).
|
|
|
|
## Uninstallation
|
|
|
|
Before uninstalling, first run `komorebic stop` to make sure that
|
|
the `komorebi` processes have been stopped.
|
|
|
|
Finally, you can run the following commands to clean up files created by the
|
|
`quickstart` command and any other runtime files:
|
|
|
|
```powershell
|
|
rm -rf ~/.cargo/bin/komorebi
|
|
rm -rf ~/.cargo/bin/komorebic
|
|
rm -rf ~/.cargo/bin/komorebi-bar
|
|
rm -rf ~/.config/komorebi
|
|
rm -rf "~/Library/Application Support/komorebi"
|
|
```
|