https://github.com/starise/komorebi-tray
A tray app to manage komorebi tiling window manager for Windows.
https://github.com/starise/komorebi-tray
autohotkey autohotkey-v2 hotkeys komorebi komorebi-launcher komorebi-tray virtual-desktop virtual-desktops
Last synced: 2 months ago
JSON representation
A tray app to manage komorebi tiling window manager for Windows.
- Host: GitHub
- URL: https://github.com/starise/komorebi-tray
- Owner: starise
- License: isc
- Created: 2024-06-02T21:56:06.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-01-12T00:01:59.000Z (3 months ago)
- Last Synced: 2025-01-12T00:26:09.096Z (3 months ago)
- Topics: autohotkey, autohotkey-v2, hotkeys, komorebi, komorebi-launcher, komorebi-tray, virtual-desktop, virtual-desktops
- Language: AutoHotkey
- Homepage:
- Size: 250 KB
- Stars: 7
- Watchers: 2
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-komorebi - komorebi-tray - A tray app to manage komorebi, the tiling window manager for Windows (Tray Indicators)
README
# 
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.
## Quick start
Install Komorebi Tray using the latest [MSI Windows Installer](https://github.com/starise/komorebi-tray/releases/latest) or **Scoop**.
```powershell
scoop bucket add confetti https://github.com/starise/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\`.
- Load new profiles: `Right click -> Reload`.
- Enable a new profile: `Right click -> Profiles -> profile.ahk`.