komorebi-tray

KO | EN

gitlite — search

#javascript #react #ai #typescript #llm #android #deep-learning #nodejs #windows #awesome #kubernetes #awesome-list #vue #ios

(★ 24)

A tray app to manage komorebi tiling window manager for Windows.

komorebi-tray Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# <img src="images/png/app.png" width="24"> Komorebi Tray

A tray app to manage komorebi tiling window manager for Windows.

- Switch between **multiple AutoHotkey profiles**.
- Show the current **workspace number** on tray icon.
- Show **workspace name** popup on workspace change.
- Start/Stop/Pause komorebi using the tray menu.
- Click on the tray icon to Pause/Resume komorebi.

Komorebi can be started, stopped and paused externally and the app will adjust accordingly: **it works independently from komorebi** and does not require any change to your current komorebi configuration (see [Quick start](#quick-start)).

If the app is already running but the connection with komorebi is lost, the app will wait for komorebi to start. If the app is started but komorebi has not been launched yet, the app will attempt to launch komorebi. This is useful if you want to use this app as a _launcher_ for Komorebi at Windows startup.

![Komorebi Tray Preview](https://raw.githubusercontent.com/starise/komorebi-tray/main/images/preview.png)

## Quick start

Install Komorebi Tray using the latest [MSI Windows Installer](https://github.com/alysoid/komorebi-tray/releases/latest) or **Scoop**.

```powershell
scoop bucket add confetti https://github.com/alysoid/Scoop-Confetti
scoop install komorebi-tray
```

No changes to your default komorebi configuration are needed. The only requirement is to set the `KOMOREBI_CONFIG_HOME` environment variable for your user, which is used to read the current komorebi configuration and for multiple AutoHotkey profile management.

```powershell
# Set KOMOREBI_CONFIG_HOME for the user
[System.Environment]::SetEnvironmentVariable("KOMOREBI_CONFIG_HOME", "$($Env:USERPROFILE)\.config\komorebi", "User")

# Check your current settings
[System.Environment]::GetEnvironmentVariable("KOMOREBI_CONFIG_HOME", "User")
```

For more information, see the official [Komorebi docs](https://lgug2z.github.io/komorebi/common-workflows/komorebi-config-home.html).

## AutoHotkey profiles

Add your custom `*.ahk` scripts to `$Env:KOMOREBI_CONFIG_HOME\profiles\`.

> [!IMPORTANT]
> `KOMOREBI_CONFIG_HOME\komorebi.ahk` is no longer managed. An existing file
> can be removed if it is not used independently.

- Load new profiles: `Right click -> Reload`.
- Enable a new profile: `Right click -> Profiles -> profile.ahk`.

## Development

See [`CONTRIBUTING.md`](CONTRIBUTING.md).

## Build from source

Requirements: Windows, Node.js 24, pnpm, and WiX 7 for the MSI.

```powershell
pnpm install
pnpm run setup
pnpm run build
```

The version in `package.json` controls the executable metadata and the ZIP/MSI
names. The archive and installer are written to `build/`.

komorebi-tray

komorebi-tray Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

komorebi-tray

komorebi-tray Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README